# 招商银行聚合支付接口

**Repository Path**: zenglijuan/polypay_all

## Basic Information

- **Project Name**: 招商银行聚合支付接口
- **Description**: polypay“聚合收款”是招商银行依托银行、三方支付及清算组织的支付通道与清算能力，集成了招商银行两个零售端APP、银联二维码、支付宝支付、微信支付等主流的支付平台，为B端商户提供收款服务的金融产品。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 10
- **Created**: 2022-09-30
- **Last Updated**: 2022-09-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



```
文档概述
1.1文档说明
本文阅读对象：商户平台服务方涉及的技术架构师，研发工程师，测试工程师，系统运维工程师。
版本说明：持续更新，详见文档更新日志
1.2术语
1.2.1支付模式
1、收款码主扫支付
收款码主扫支付是商户系统通过HTTPS请求报文调用聚合收单平台提供的API生成动态聚合银标码，用户再用微信、支付宝、银联钱包等第三方APP“扫一扫”完成支付的模式。该模式适用于PC网站支付、实体店单品或订单支付、媒体广告支付等场景。
2、被扫用户付款码支付
被扫用户付款码支付是用户展示微信，支付宝或银联钱包内的“刷卡条码/二维码”给商户系统扫描后直接完成支付的模式。主要应用线下面对面收银的场景。
3、微信统一下单
微信统一下单目前支持微信公众号支付、小程序支付和APP支付三种模式，公众号支付和小程序支付是指用户在微信公众账号内进入商家公众号、用户打开好友在朋友圈和聊天窗口等分享商家页面链接或在商家小程序中进入商家页面，商户在H5页面通过调用微信支付提供的JSAPI接口调起微信支付模块完成支付，APP支付又称移动端支付，是用户登录商家APP进行下单，商户通过在移动端应用APP中集成开放SDK调起支付模块完成支付的模式。
4、支付宝服务窗支付
支付宝服务窗支付是指用户使用支付宝通过扫码或打开好友分享的商家页面链接而进入商家页面，商户在H5页面通过调用支付宝提供的JSAPI接口调起支付宝支付模块完成支付。
1.2.2名词解释
1、聚合收单平台
提供聚合收单服务，为我行商户提供了融合多个支付渠道，一站式资金结算和对账的技术解决方案，降低了我行商户系统投入和运营成本，提供了资金结算和财务对账效率的实际需求。主要支付媒体包括: ERP系统、收银台、聚合收款APP、公众号、固定二维码。支付通道：支付宝、微信、银联二维码。
2、商户收银系统
商户收银系统即商户的POS收银系统，是录入商品信息、生成订单、客户支付、打印小票等功能的系统。接入微信支付功能主要涉及到POS软件系统的开发和测试，所以在下文中提到的商户收银系统特指POS收银软件系统。
3、商户后台系统
商户后台系统是商户后台处理业务系统的总称，例如：商户网站、收银系统、进销存系统、发货系统、客服系统等。
4、扫码设备
一种输入设备，主要用于商户系统快速读取媒介上的图形编码信息。按读取码的类型不同，可分为条码扫码设备和二维码扫码设备。按读取物理原理可分为红外扫码设备、激光扫码设备。
5、商户证书（暂未启用）
商户证书是聚合收单平台提供的二进制文件，商户系统发起与平台支付后台服务器通信请求的时候，作为平台支付后台识别商户真实身份的凭据。
6、签名
聚合收单平台需要验证商户上送的签名是否正确；商户收到应答，也需要验证签名是否正确，如果商户未正确验证签名，存在潜在的风险，商户自行承担因此而产生的所有损失。
商户后台和聚合收单平台后台根据非对称的密钥对和RSA2算法校验双方身份合法性。签名的算法由聚合收单平台制定并公开，常用的签名方式有：MD5、SHA1、SHA256、HMAC等（目前仅支持RSA2算法），测试环境签名所使用的RSA2公私钥对信息请参见附录1。
7、支付密码
支付密码是用户开通微信、支付宝、银联钱包等支付时单独设置的密码，用于确认支付完成交易授权。
8、Openid
用户在聚合收单平台内的身份标识，不同商户号拥有不同的openid。商户后台系统通过登录授权、支付通知、查询订单等API可获取到用户的openid。主要用途是判断同一个用户，对用户发送客服消息、模版消息等。

2.接口规则
2.1服务器地址
测试环境地址：
收款码申请：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/qrcodeapply
支付结果查询：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/orderquery
退款申请：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/refund
退款结果查询：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/refundquery
付款码收款：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/pay
微信统一下单：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/onlinepay
付款码收款撤销：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/cancel
关闭订单：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/close
支付宝服务窗支付：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/servpay
支付宝native支付：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/zfbqrcode
微信native支付：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/wxqrcode
对账单下载地址获取：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/statementurl
秘钥设置：
https://api.cmburl.cn:8065/polypay/v1.0/mchkey/keyset
订单二维码申请
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/orderqrcodeapply
微信小程序下单：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/MiniAppOrderApply
银联云闪付：
https://api.cmburl.cn:8065/polypay/v1.0/mchorders/cloudpay


因交易结果通知是银行主动通知给商户的，故不提供商户主动调用的URL。

生产接入地址：
收款码申请：
https://api.cmbchina.com/polypay/v1.0/mchorders/qrcodeapply
支付结果查询：
https://api.cmbchina.com/polypay/v1.0/mchorders/orderquery
退款申请：
https://api.cmbchina.com/polypay/v1.0/mchorders/refund
退款结果查询：
https://api.cmbchina.com/polypay/v1.0/mchorders/refundquery
付款码收款：
https://api.cmbchina.com/polypay/v1.0/mchorders/pay
微信统一下单：
https://api.cmbchina.com/polypay/v1.0/mchorders/onlinepay
付款码收款撤销：
https://api.cmbchina.com/polypay/v1.0/mchorders/cancel
关闭订单：
https://api.cmbchina.com/polypay/v1.0/mchorders/close
支付宝服务窗支付：
https://api.cmbchina.com/polypay/v1.0/mchorders/servpay
支付宝native支付：
https://api.cmbchina.com/polypay/v1.0/mchorders/zfbqrcode
微信native支付：
https://api.cmbchina.com/polypay/v1.0/mchorders/wxqrcode
对账单下载地址获取：
https://api.cmbchina.com/polypay/v1.0/mchorders/statementurl
秘钥设置：
https://api.cmbchina.com/polypay/v1.0/mchkey/keyset
订单二维码申请：
https://api.cmbchina.com/polypay/v1.0/mchorders/orderqrcodeapply
微信小程序下单：
https://api.cmbchina.com/polypay/v1.0/mchorders/MiniAppOrderApply
银联云闪付：
https://api.cmbchina.com/polypay/v1.0/mchorders/cloudpay
```