|
|
@@ -1,24 +1,24 @@
|
|
|
-# AllPay在线支付接入规范文档V5.0.0
|
|
|
-[上海偶可贝网络科技有限公司](https://www.allpayx.com)
|
|
|
+# GoAllPay在线支付接入规范文档V5.0.0
|
|
|
+[上海偶可贝网络科技有限公司](https://www.goallpayx.com)
|
|
|
|
|
|
* 版本信息：中文 V5.0.0
|
|
|
* 更新时间：2019 年1 月
|
|
|
|
|
|
## 1.概述
|
|
|
-AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全、集中式的接入支付渠道。
|
|
|
+GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安全、集中式的接入支付渠道。
|
|
|
## 2.交易流程
|
|
|
|
|
|
## 3.验签说明
|
|
|
```
|
|
|
-1.对于发送到 AllPay 系统的 POST 请求报文，其中所有传入参数（除 signature 参数外）按照字段名的 ASCII 码从小到大排序后（字典序），使用 URL 键值对的格式（即 key1=value1&key2=value2...）拼接成字符串 String1。
|
|
|
+1.对于发送到 GoAllPay 系统的请求报文，其中所有传入参数（除 signature 参数外）按照字段名的 ASCII 码从小到大排序后（字典序），使用 URL 键值对的格式（即 key1=value1&key2=value2...）拼接成字符串 String1。
|
|
|
|
|
|
-2.在 String1 最后直接拼接（不需要用“&”连接）双方约定的签名密钥 Key（接入 AllPay 时分配），得到 stringSignTemp 字符串，并对 stringSignTemp 进行加密运算，得到 signature 的值。
|
|
|
+2.在 String1 最后直接拼接（不需要用“&”连接）双方约定的签名密钥 Key（接入 GoAllPay 时分配），得到 stringSignTemp 字符串，并对 stringSignTemp 进行加密运算，得到 signature 的值。
|
|
|
|
|
|
3.示例签名串 acqID=99020344&backURL=https://baidu.com&charSet=UTF-8&detailInfo=W3siZ29vZHNfbmFtZSI6IuWNjuS4ulAyMCIsInF1YW50aXR5IjoiMiJ9LHsiZ29vZHNfbmFtZSI6IuWNjuS4ulAyMCBwbHVzIiwicXVhbnRpdHkiOiI0In1d&frontURL=https://mchapi.allpayx.com/demo&goodsInfo=华为P20&merID=000000000000015&merReserve=你好&orderAmount=1&orderCurrency=HKD&orderNum=dKmdb4S9Tv1a9ZpkMjeDawV82MCJ&paymentSchema=AP&signType=MD5&transTime=20181206134515&transType=PURC&version=VER0000000052f2c77e3718c47cfb47a89a6fbc9d361
|
|
|
```
|
|
|
## 4.通用API说明
|
|
|
|
|
|
-商户服务器和 AllPay 网关对接的通用接口，每个渠道都具有的功能，包括：消费，消费查询，退款，退款查询。
|
|
|
+商户服务器和 GoAllPay 网关对接的通用接口，每个渠道都具有的功能，包括：消费，消费查询，退款，退款查询。
|
|
|
|
|
|
### 4.1 通用 API 接入地址
|
|
|
|
|
|
@@ -56,7 +56,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| orderCurrency | String(3) | M | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD" |
|
|
|
| frontURL | String(400) | M | 支付完成后跳转到该地址 |
|
|
|
| backURL | String(400) | M | 支付结果异步通知到该地址 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：[点击查看详情](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
|
|
|
| goodsInfo | String(60) | M | 商品信息,在支付页面上显示。 |
|
|
|
@@ -68,9 +68,9 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
|
|
|
3.跳转型消费接口响应报文
|
|
|
|
|
|
- 商户需要提供一个 http/https 协议的接口，包含在参数里传递给AllPay，即 backURL。AllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果。商户在接收到通知后，需返回“OK”。
|
|
|
+ 商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果。商户在接收到通知后，需返回“OK”。
|
|
|
|
|
|
- 如果没有收到商户返回“OK”，AllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
+ 如果没有收到商户返回“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
|
|
|
推送参数如下表：
|
|
|
|
|
|
@@ -82,7 +82,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| 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 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第6章应答码 |
|
|
|
@@ -105,8 +105,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
|
|
|
（2）接口交易流程
|
|
|
|
|
|
-
|
|
|
-
|
|
|
|
|
|
|
|
|
2.请求报文格式
|
|
|
@@ -117,7 +115,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| charSet | String(6) | M | 统一填写为“UTF-8” |
|
|
|
| transType | String(4) | M | 查询填写“INQY” |
|
|
|
| orderNum | String(60) | M | 支付订单号 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -133,7 +131,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(4) | M | 查询填写“INQY” |
|
|
|
| orderNum | String(60) | M | 支付订单号 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第6章应答码 |
|
|
|
@@ -156,8 +154,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
|
|
|
（2）接口交易流程
|
|
|
|
|
|
-
|
|
|
-
|
|
|
|
|
|
|
|
|
2.请求报文格式
|
|
|
@@ -171,7 +167,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| origOrderNum | String(60) | M | 原支付订单号 |
|
|
|
| returnAmount | String(12) | M | 退款金额：如 100 元，表示为 100 或 100.00 |
|
|
|
| orderCurrency | String(3) | M | 订单币种：ISO标准 如：人民币填写“CNY”,美元填写"USD" |
|
|
|
-| merID | String(15) | M | 商户 ID，由AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -187,7 +183,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(4) | M | 退款填写“REFD” |
|
|
|
| orderNum | String(60) | M | 退款订单号 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第6章应答码 |
|
|
|
@@ -208,8 +204,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
|
|
|
（2）接口交易流程
|
|
|
|
|
|
-
|
|
|
-
|
|
|
|
|
|
|
|
|
2.请求报文格式
|
|
|
@@ -220,7 +214,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| charSet | String(6) | M | 统一填写为“UTF-8” |
|
|
|
| transType | String(4) | M | 查询填写“RFQY” |
|
|
|
| orderNum | String(60) | M | 退款订单号 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
|
|
|
| transTime | String(14) | M | 交易时间，格式:"yyyyMMddHHmmss" |
|
|
|
@@ -236,7 +230,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(4) | M | 查询填写“RFQY” |
|
|
|
| orderNum | String(60) | M | 退款订单号 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：[点击这里](https://git.allpayx.com/OpenAPI/common/src/master/paymentSchema.md) |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第6章应答码 |
|
|
|
@@ -266,7 +260,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| orderCurrency | String(3) | M | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD" |
|
|
|
| frontURL | String(400) | M | 支付完成后跳转到该地址 |
|
|
|
| backURL | String(400) | M | 支付结果异步通知到该地址 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| goodsInfo | String(60) | M | 商品信息,在支付页面上显示。 |
|
|
|
@@ -278,9 +272,9 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
|
|
|
3.响应报文
|
|
|
|
|
|
- 商户需要提供一个 http/https 协议的接口，包含在参数里传递给AllPay，即 backURL。AllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果。商户在接收到通知后，需返回“OK”。
|
|
|
+ 商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果。商户在接收到通知后，需返回“OK”。
|
|
|
|
|
|
- 如果没有收到商户返回“OK”，AllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
+ 如果没有收到商户返回“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
|
|
|
推送参数如下表：
|
|
|
|
|
|
@@ -292,7 +286,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| 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 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第6章应答码 |
|
|
|
@@ -317,8 +311,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
|
|
|
（2）接口交易流程
|
|
|
|
|
|
-
|
|
|
-
|
|
|
|
|
|
|
|
|
2.请求报文格式
|
|
|
@@ -332,7 +324,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| origOrderNum | String(60) | M | 原预授权订单号 |
|
|
|
| orderAmount | String(12) | M | 订单金额：如 100 元，表示为 100 或 100.00 |
|
|
|
| orderCurrency | String(3) | M | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD" |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -348,7 +340,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(4) | M | 预授权完成填写“PAUC” |
|
|
|
| orderNum | String(60) | M | 预授权完成订单号 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第6章应答码 |
|
|
|
@@ -369,8 +361,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
|
|
|
（2）接口交易流程
|
|
|
|
|
|
-
|
|
|
-
|
|
|
|
|
|
|
|
|
2.请求报文格式
|
|
|
@@ -382,7 +372,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(4) | M | 填写“VOID” |
|
|
|
| orderNum | String(60) | M | 订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
| origOrderNum | String(60) | M | 原交易订单号：要撤销的订单号，可以为消费、预授权、预授权完成的orderNum |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -398,7 +388,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(4) | M | 填写“VOID” |
|
|
|
| orderNum | String(60) | M | 撤销订单号 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第6章应答码 |
|
|
|
@@ -425,7 +415,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| origOrderNum | String(60) | M | 原支付订单号 |
|
|
|
| returnAmount | String(12) | M | 退款金额：如 100 元，表示为 100 或 100.00 |
|
|
|
| orderCurrency | String(3) | M | 订单币种：ISO标准 如：人民币填写“CNY”,美元填写"USD" |
|
|
|
-| merID | String(15) | M | 商户 ID，由AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -441,7 +431,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(4) | M | 人工退款填写“MANREFD” |
|
|
|
| orderNum | String(60) | M | 退款订单号 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| RespCode | String(2) | M | 应答码 00 代表申请已受理 |
|
|
|
@@ -451,8 +441,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-
|
|
|
-
|
|
|
### 4.10 外卡绑卡接口
|
|
|
|
|
|
1.接口功能说明
|
|
|
@@ -469,17 +457,15 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
| frontURL | String(400) | M | 绑定结果前端跳转地址 |
|
|
|
| backURL | String(400) | M | 绑定成功后异步通知到该地址 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| paymentSchema | String(10) | M | 渠道代码:FC |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-
|
|
|
-
|
|
|
绑卡分两种模式
|
|
|
|
|
|
-(1) 用户在商户平台选择添加卡，然后跳转至AllPay的绑卡页面，用户在此页面输入卡号信息.绑卡失败,则返失败通知给商户；绑卡成功，返一个“token+customer ID+卡号后四位”给商户。
|
|
|
+(1) 用户在商户平台选择添加卡，然后跳转至GoAllPay的绑卡页面，用户在此页面输入卡号信息.绑卡失败,则返失败通知给商户；绑卡成功，返一个“token+customer ID+卡号后四位”给商户。
|
|
|
|
|
|
方式一专属字段
|
|
|
|
|
|
@@ -487,7 +473,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| --------- | ------ | ---- | ---- |
|
|
|
| tradeFrom | String | M | "H5" |
|
|
|
|
|
|
-(2)商户自己收集卡号信息通过API送到AllPay网关.
|
|
|
+(2)商户自己收集卡号信息通过API送到GoAllPay网关.
|
|
|
|
|
|
方式二专属字段
|
|
|
|
|
|
@@ -498,12 +484,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| cvv2 | String | M | cvv2 |
|
|
|
| ExpiryDate | String | M | 有效期:格式 MM/YY |
|
|
|
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
3.响应报文格式
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
@@ -512,7 +492,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(10) | M | 绑卡 "BIND" |
|
|
|
| orderNum | String(60) | M | 绑卡订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| RespCode | String(2) | M | 应答码 00 代表成功 |
|
|
|
| RespMsg | String(20) | M | 应答消息 |
|
|
|
@@ -524,8 +504,6 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-
|
|
|
-
|
|
|
### 4.11 外卡解绑接口
|
|
|
|
|
|
1.接口功能说明
|
|
|
@@ -541,7 +519,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| orderNum | String(60) | M | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
| token | String(32) | M | 绑卡时返回的token |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| paymentSchema | String(10) | M | 渠道代码:FC |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
@@ -555,7 +533,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| transType | String(10) | M | 绑卡 "UNBIND" |
|
|
|
| orderNum | String(60) | M | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| RespCode | String(2) | M | 应答码 00 代表成功 |
|
|
|
| RespMsg | String(20) | M | 应答消息 |
|
|
|
@@ -567,11 +545,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-
|
|
|
-### 4.11 绑卡消费接口
|
|
|
+### 4.12 绑卡消费接口
|
|
|
|
|
|
1.接口功能说明
|
|
|
|
|
|
@@ -592,7 +566,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| backURL | String(400) | M | 支付结果异步通知到该地址 |
|
|
|
| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
| token | String(32) | M | 绑卡时返回的token |
|
|
|
-| merID | String(15) | M | 商户 ID，由 AllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| 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编码后签名上送。 |
|
|
|
@@ -611,7 +585,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
| 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 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第6章应答码 |
|
|
|
@@ -649,7 +623,7 @@ AllPay 为客户提供统一的API接入，以帮助客户实现快速、安全
|
|
|
|
|
|
#### 5.1.2 二维码跳转模式
|
|
|
|
|
|
-该模式会为商户跳转到AllPay生成好的二维码页面，无需商户自己生成。
|
|
|
+该模式会为商户跳转到GoAllPay生成好的二维码页面，无需商户自己生成。
|
|
|
|
|
|
消费接口专属字段
|
|
|
|
|
|
@@ -892,8 +866,8 @@ cvv：123
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------ | ------ | ---- | ------------------------------------------------------------ |
|
|
|
| tradeFrom | String | M | "H5" |
|
|
|
-| showShipAddr | String | M | "1"：显示账单填写表单, "0"不显示账单填写表单 |
|
|
|
-| shipAddr | String | O | shipAddr=base64(json) {"first_name":"wei","last_name":"wei","street":"address_line1","house_number":"address_line2","address_city":"new york","address_state":"new york","country_id":"us","address_zip":"10022","phone_num":"13512345678","email_address":"[123@126.com](/var/folders/1f/9gtyznm175q4m4fhm5sswlj00000gn/T/abnerworks.Typora/DF605CE9-C0DF-4E36-B77B-A576775DAC1C/mailto:123@126.com)"} |
|
|
|
+| showShipAddr | String | M | "1"：显示账单填写表单, "0"：不显示账单填写表单 |
|
|
|
+| shipAddr | String | O | shipAddr=base64(json) <br>{"first_name":"wei","last_name":"wei","street":"address_line1","house_number":"address_line2","address_city":"new york","address_state":"new york","country_id":"us","address_zip":"10022","phone_num":"13512345678","email_address":"123@126.com"} |
|
|
|
|
|
|
```javascript
|
|
|
测试卡：
|
|
|
@@ -931,6 +905,24 @@ CVC: 737
|
|
|
| RespMsg | String | M | 应答消息 |
|
|
|
| code_url | String | O | 二维码字符串。应答码为00返回该字段 |
|
|
|
|
|
|
+#### 5.9.3 APP支付
|
|
|
+
|
|
|
+ 消费接口专属字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| --------- | ------ | ---- | ----- |
|
|
|
+| tradeFrom | String | M | "APP" |
|
|
|
+
|
|
|
+应答报文：
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| -------- | ------ | ---- | --------------------------------------------------------- |
|
|
|
+| RespCode | String | M | 应答码 00-成功 |
|
|
|
+| RespMsg | String | M | 应答消息 |
|
|
|
+| tn | String | O | 交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数 |
|
|
|
+
|
|
|
+获取到tn后，根据本文档第7节调用SDK进行支付。
|
|
|
+
|
|
|
### 5.10 FC渠道
|
|
|
|
|
|
#### 5.10.1 消费/预授权
|
|
|
@@ -947,6 +939,14 @@ CVC: 737
|
|
|
卡号: 4761340000000019
|
|
|
有效期: 1217
|
|
|
CVV2: 830
|
|
|
+
|
|
|
+卡号: 5204730000002555
|
|
|
+有效期: 1225
|
|
|
+CVV2: 123
|
|
|
+
|
|
|
+卡号: 5200831111111113
|
|
|
+有效期: 1119
|
|
|
+CVV2: 123
|
|
|
```
|
|
|
|
|
|
## 6.应答码
|
