绑卡

AllPay_Integration_Specification_CH.md

@@ -32,6 +32,9 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
 | 预授权完成 | https://testapi.allpayx.com/api/pauc | https://api.allpayx.com/api/pauc |
 | 撤销 | https://testapi.allpayx.com/api/canc | https://api.allpayx.com/api/canc |
 | 手工退款 | https://testapi.allpayx.com/api/manrefd | https://api.allpayx.com/api/manrefd |
+| 卡片绑定 | https://testapi.allpayx.com/api/bindCard | https://api.allpayx.com/api/bindCard |
+| 卡片解绑 | https://testapi.allpayx.com/api/unBindCard | https://api.allpayx.com/api/unBindCard |
+| 绑卡支付 | https://testapi.allpayx.com/api/bindPay | https://api.allpayx.com/api/bindPay |
 
 ### 4.2 消费交易接口
 
@@ -197,7 +200,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
 1.接口说明
 
  该接口为接入商家提供退款查询的功能。
- 
+
 （1）接口补充说明
  * 该接口用于商户在退款发起后，查询退款交易的处理状态
 
@@ -359,7 +362,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
  （1）接口补充说明
  * 该接口支持对外卡消费、预授权、预授权完成交易进行撤消
  * 对消费进行撤消时，只能支持撤消当日交易（注意：北京时间23:00后，视为隔天）。对于非当日交易，可以通过退款接口进行处理。
- 
+
  （2）接口交易流程
  <div align=center>
  ![](https://allpayfile-hd2.oss-cn-shanghai.aliyuncs.com/git/b2c/15665464582903.jpg)
@@ -412,7 +415,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
 | ------------- | ---------- | ---- | ------------------------------------------------------------ |
 | version       | String(12) | M    | 统一填写为“VER000000005”                                     |
 | charSet       | String(6)  | M    | 统一填写为“UTF-8”                                            |
-| transType     | String(4)  | M    | 人工退款填写“MANREFD”                                        |
+| transType     | String(10) | M    | 人工退款填写“MANREFD”                                        |
 | orderNum      | String(60) | M    | 退款申请单号:商户自行定义，需保证同一商户号下退款订单号不能重复 |
 | origOrderNum  | String(60) | M    | 原支付订单号                                                 |
 | returnAmount  | String(12) | M    | 退款金额：如 100 元，表示为 100 或 100.00                    |
@@ -443,6 +446,157 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
 | signType      | String(10) | M    | MD5或SHA256                                    |
 | signature     | String(32) | M    | 采用 MD5或SHA256 签名                          |
 
+
+
+### 4.10 外卡绑卡接口
+
+1.接口功能说明 
+
+​     用户在商户平台选择添加卡，然后跳转至AllPay的绑卡页面，用户在此页面输入卡号信息.绑卡失败,则返失败通知给商户；绑卡成功，返一个“token+customer ID+卡号后四位”给商户。
+
+2.请求报文格式 
+
+| 参数          | 类型        | 属性 | 描述                                                       |
+| ------------- | ----------- | ---- | ---------------------------------------------------------- |
+| version       | String(12)  | M    | 统一填写为“VER000000005”                                   |
+| charSet       | String(6)   | M    | 统一填写为“UTF-8”                                          |
+| transType     | String(10)  | M    | 绑卡 "BIND"                                                |
+| orderNum      | String(60)  | M    | 绑卡订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
+| customerId    | String(60)  | M    | 用户ID:  商户自行定义，需保证同一商户号下不同用户不能重复  |
+| frontURL      | String(400) | M    | 绑定结果前端跳转地址                                       |
+| backURL       | String(400) | M    | 绑定成功后异步通知到该地址                                 |
+| merID         | String(15)  | M    | 商户 ID，由 AllPay 分配                                    |
+| acqID         | String(11)  | M    | 收单行 ID "99020344"                                       |
+| paymentSchema | String(10)  | M    | 渠道代码:FC                                                |
+| transTime     | String(14)  | M    | 交易时间，格式："yyyyMMddHHmmss"                           |
+| signType      | String(10)  | M    | MD5或SHA256                                                |
+| signature     | String(32)  | M    | 采用 MD5或SHA256 签名                                      |
+
+3.响应报文格式
+
+| 参数          | 类型       | 属性 | 描述                                                       |
+| ------------- | ---------- | ---- | ---------------------------------------------------------- |
+| version       | String(12) | M    | 统一填写为“VER000000005”                                   |
+| charSet       | String(6)  | M    | 统一填写为“UTF-8”                                          |
+| transType     | String(10) | M    | 绑卡 "BIND"                                                |
+| orderNum      | String(60) | M    | 绑卡订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
+| transID       | String(32) | M    | GW 系统生成的交易 ID，每笔交易保持唯一                     |
+| merID         | String(15) | M    | 商户 ID，由 AllPay 分配                                    |
+| acqID         | String(11) | M    | 收单行 ID "99020344"                                       |
+| paymentSchema | String(10) | M    | 渠道代码：FC                                               |
+| RespCode      | String(2)  | M    | 应答码 00 代表成功                                         |
+| RespMsg       | String(20) | M    | 应答消息                                                   |
+| token         | String(32) | O    | 应答码为 00时返回                                          |
+| customerId    | String(60) | O    | 用户ID:  商户自行定义，需保证同一商户号下不同用户不能重复  |
+| cardNoTail    | String(4)  | O    | 卡号后四位                                                 |
+| transTime     | String(14) | M    | 交易时间，格式："yyyyMMddHHmmss"                           |
+| GWTime        | String(14) | M    | YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间             |
+| signType      | String(10) | M    | MD5或SHA256                                                |
+| signature     | String(32) | M    | 采用 MD5或SHA256 签名                                      |
+
+
+
+### 4.11 外卡解绑接口
+
+1.接口功能说明 
+
+   解除绑定的卡片
+
+2.请求报文格式 
+
+| 参数          | 类型       | 属性 | 描述                                                       |
+| ------------- | ---------- | ---- | ---------------------------------------------------------- |
+| version       | String(12) | M    | 统一填写为“VER000000005”                                   |
+| charSet       | String(6)  | M    | 统一填写为“UTF-8”                                          |
+| transType     | String(10) | M    | 绑卡 "UNBIND"                                              |
+| orderNum      | String(60) | M    | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
+| customerId    | String(60) | M    | 用户ID:  商户自行定义，需保证同一商户号下不同用户不能重复  |
+| token         | String(32) | M    | 绑卡时返回的token                                          |
+| merID         | String(15) | M    | 商户 ID，由 AllPay 分配                                    |
+| acqID         | String(11) | M    | 收单行 ID "99020344"                                       |
+| paymentSchema | String(10) | M    | 渠道代码:FC                                                |
+| transTime     | String(14) | M    | 交易时间，格式："yyyyMMddHHmmss"                           |
+| signType      | String(10) | M    | MD5或SHA256                                                |
+| signature     | String(32) | M    | 采用 MD5或SHA256 签名                                      |
+
+3.响应报文格式
+
+| 参数          | 类型       | 属性 | 描述                                                       |
+| ------------- | ---------- | ---- | ---------------------------------------------------------- |
+| version       | String(12) | M    | 统一填写为“VER000000005”                                   |
+| charSet       | String(6)  | M    | 统一填写为“UTF-8”                                          |
+| transType     | String(10) | M    | 绑卡 "UNBIND"                                              |
+| orderNum      | String(60) | M    | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
+| transID       | String(32) | M    | GW 系统生成的交易 ID，每笔交易保持唯一                     |
+| merID         | String(15) | M    | 商户 ID，由 AllPay 分配                                    |
+| acqID         | String(11) | M    | 收单行 ID "99020344"                                       |
+| paymentSchema | String(10) | M    | 渠道代码：FC                                               |
+| RespCode      | String(2)  | M    | 应答码 00 代表成功                                         |
+| RespMsg       | String(20) | M    | 应答消息                                                   |
+| customerId    | String(60) | O    | 用户ID:  商户自行定义，需保证同一商户号下不同用户不能重复  |
+| cardNoTail    | String(4)  | O    | 卡号后四位                                                 |
+| transTime     | String(14) | M    | 交易时间，格式："yyyyMMddHHmmss"                           |
+| GWTime        | String(14) | M    | YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间             |
+| signType      | String(10) | M    | MD5或SHA256                                                |
+| signature     | String(32) | M    | 采用 MD5或SHA256 签名                                      |
+
+
+
+
+
+### 4.11 绑卡消费接口
+
+1.接口功能说明 
+
+   绑卡消费支付,根据绑卡时返回的token,对用户进行扣款
+
+2.请求报文格式 
+
+ 下面列举的字段为通用字段，每个渠道都需要上送，部分渠道有专属字段，具体请到第5章渠道专属配置处查看。
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000005”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 消费填写“PURC”                                               |
+| orderNum      | String(60)   | M    | 订单号：商户自行定义，需保证同一商户号下订单号不能重复       |
+| orderAmount   | String(12)   | M    | 订单金额：如 100 元，表示为 100 或 100.00                    |
+| orderCurrency | String(3)    | M    | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"        |
+| customerId    | String(60)   | M    | 用户ID:  商户自行定义，需保证同一商户号下不同用户不能重复    |
+| token         | String(32)   | M    | 绑卡时返回的token                                            |
+| merID         | String(15)   | M    | 商户 ID，由 AllPay 分配                                      |
+| acqID         | String(11)   | M    | 收单行 ID "99020344"                                         |
+| paymentSchema | String(10)   | M    | 渠道代码：FC                                                 |
+| detailInfo    | String(400)  | M    | 商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该字段进行base-64编码后签名上送。 |
+| transTime     | String(14)   | M    | 交易时间，格式："yyyyMMddHHmmss"                             |
+| merReserve    | String(1024) | O    | 商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号等。 |
+| signType      | String(10)   | M    | MD5或SHA256                                                  |
+| signature     | String(32)   | M    | 采用 MD5或SHA256 签名                                        |
+
+3.响应报文
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000005”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 消费填写“PURC”                                               |
+| orderNum      | String(60)   | M    | 订单号                                                       |
+| orderAmount   | String(12)   | M    | 订单金额：如 100 元，表示为 100 或 100.00                    |
+| orderCurrency | String(3)    | M    | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"        |
+| merID         | String(15)   | M    | 商户 ID，由 AllPay 分配                                      |
+| acqID         | String(11)   | M    | 收单行 ID "99020344"                                         |
+| paymentSchema | String(10)   | M    | 渠道代码：FC                                                 |
+| RespCode      | String(2)    | M    | 应答码 00-成功，01-失败。详情见本文档第6章应答码             |
+| RespMsg       | String(20)   | M    | 应答消息                                                     |
+| transID       | String(32)   | M    | GW 系统生成的交易 ID，每笔交易保持唯一                       |
+| GWTime        | String(14)   | M    | yyyyMMddHHmmss，为 GW 时间                                   |
+| transTime     | String(14)   | M    | 交易时间，格式："yyyyMMddHHmmss"                             |
+| merReserve    | String(1024) | O    | 商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号。 |
+| signType      | String(10)   | M    | MD5或SHA256                                                  |
+| signature     | String(32)   | M    | 采用 MD5或SHA256 签名                                        |
+
+### 
+
 ## 5.渠道专属配置
 
 ### 5.1 WX渠道