benson 5 years ago
parent
commit
e42f4ffdd9
1 changed files with 112 additions and 2 deletions
  1. 112 2
      AllPay_Integration_Specification_CH.md

+ 112 - 2
AllPay_Integration_Specification_CH.md

@@ -26,6 +26,8 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | 消费查询 | https://testapi.allpayx.com/api/orderquery   | https://api.allpayx.com/api/orderquery   |
 | 退款    | https://testapi.allpayx.com/api/refund       | https://api.allpayx.com/api/refund       |
 | 退款查询 | https://testapi.allpayx.com/api/refundquery  | https://api.allpayx.com/api/refundquery  |
+| 预授权 | https://testapi.allpayx.com/api/unifiedorder | https://api.allpayx.com/api/unifiedorder |
+| 预授权完成 | https://testapi.allpayx.com/api/pauc | https://api.allpayx.com/api/pauc |
 
 ### 4.2 消费交易接口
 
@@ -208,6 +210,100 @@ AllPay 为客户提供统一的API接入,以帮助客户实 现快速、安全
 | signType      | String(10) | M    | MD5或SHA256                                                  |
 | signature     | String(32) | M    | 采用 MD5或SHA256 签名                                        |
 
+
+
+### 4.6 外卡预授权接口
+
+1.接口说明
+
+ 该接口为接入商家提供预授权功能。
+
+2.请求报文格式
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000005”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 预授权填写“PAUT”                                             |
+| orderNum      | String(60)   | M    | 订单号:商户自行定义,需保证同一商户号下订单号不能重复       |
+| orderAmount   | String(12)   | M    | 订单金额:如 100 元,表示为 100 或 100.00                    |
+| orderCurrency | String(3)    | M    | 订单币种:ISO标准。如:人民币填写“CNY”,美元填写"USD"        |
+| 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                                                 |
+| goodsInfo     | String(60)   | M    | 商品信息,在支付页面上显示。                                  |
+| 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.响应报文
+
+  商户需要提供一个 http/https 协议的接口,包含在参数里传递给AllPay,即 backURL。AllPay 服务器在支付完成后,会以 Post 方式调用 backURL,通知支付结果。商户在接收到通知后,需返回“OK”。
+
+  如果没有收到商户返回“OK”,AllPay将会过一段时间后重新推送,时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400],单位为秒。
+
+推送参数如下表:
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000005”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 预授权填写“PAUT”                                             |
+| 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-成功                                               |
+| 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 签名                                        |
+
+### 
+
+### 4.6 外卡预授权完成接口
+
+1.接口说明
+
+ 该接口为接入商家提供预授权完成功能。
+
+2.请求报文格式
+
+| 参数          | 类型         | 属性 | 描述                                                         |
+| ------------- | ------------ | ---- | ------------------------------------------------------------ |
+| version       | String(12)   | M    | 统一填写为“VER000000005”                                     |
+| charSet       | String(6)    | M    | 统一填写为“UTF-8”                                            |
+| transType     | String(4)    | M    | 预授权填写“PAUC”                                             |
+| orderNum      | String(60)   | M    | 订单号:预授权单号                                           |
+| orderAmount   | String(12)   | M    | 订单金额:如 100 元,表示为 100 或 100.00                    |
+| orderCurrency | String(3)    | M    | 订单币种:ISO标准。如:人民币填写“CNY”,美元填写"USD"        |
+| 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                                                 |
+| goodsInfo     | String(60)   | M    | 商品信息,在支付页面上显示。                                  |
+| 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 签名                                        |
+
+
+
+
+
+
+
 ## 5.渠道专属配置
 
 ### 5.1 WX渠道
@@ -480,9 +576,23 @@ cvv:123
 | email             | String | M    | 用户email |
 | transport_express | String | M    | 快递单号  |
 
-## 
 
-## 6.应答码 
+
+### 5.9 FC渠道
+
+#### 5.9.1 消费, 预授权
+
+ 消费,预授权 ,接口专属字段
+
+| 参数      | 类型   | 属性 | 描述 |
+| --------- | ------ | ---- | ---- |
+| tradeFrom | String | M    | "H5" |
+
+#### 
+
+
+
+6.应答码 
 
 | 应答码 | 描  述      |
 | ------ | --------- |