|
|
@@ -10,7 +10,7 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
|
|
|
## 3.验签说明
|
|
|
```
|
|
|
-1. 对于发送到 GoAllPay 系统的请求报文，其中所有传入参数（除 signature 参数外）按照字段名的 ASCII 码从小到大排序后（字典序），使用 URL 键值对的格式（即 key1=value1&key2=value2...）拼接成字符串 String1。
|
|
|
+1. 对于发送到 GoAllPay 系统的请求，其中所有传入参数（除 signature 参数外）按照参数名的 ASCII 码从小到大排序后（字典序），使用 URL 键值对的格式（即 key1=value1&key2=value2...）拼接成字符串 String1。
|
|
|
|
|
|
|
|
|
2. 在 String1 最后直接拼接（不需要用“&”连接）双方约定的签名密钥 Key（接入 GoAllPay 时分配），得到 stringSignTemp 字符串，并对 stringSignTemp 进行加密运算，得到 signature 的值。
|
|
|
@@ -41,8 +41,8 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| 撤销 | https://testapi.allpayx.com/api/canc | https://api.allpayx.com/api/canc |
|
|
|
| 手工退款申请 | https://testapi.allpayx.com/api/refdreq | https://api.allpayx.com/api/refdreq |
|
|
|
| 签约 | 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 |
|
|
|
+| 解约 | https://testapi.allpayx.com/api/unBindCard | https://api.allpayx.com/api/unBindCard |
|
|
|
|
|
|
### 4.2 消费交易接口
|
|
|
|
|
|
@@ -50,13 +50,13 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
该接口为接入商家提供消费购买的功能。
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+**2.请求参数**
|
|
|
|
|
|
- 由通用字段和渠道专属字段组成。凡是上送字段都需参与签名。消费接口分为跳转型和参数返回型，默认为跳转型，参数返回型会在渠道专属字段中说明。
|
|
|
+ 由通用参数和渠道专属参数组成。凡是上送参数都需参与签名。消费接口分为跳转型和参数返回型，默认为跳转型，参数返回型会在渠道专属参数中说明。
|
|
|
|
|
|
- *渠道专属字段：* [点击查看](payExclusive_CH.md)
|
|
|
+ *渠道专属参数：* [点击查看](payExclusive_CH.md)
|
|
|
|
|
|
- *通用字段：*
|
|
|
+ *通用参数：*
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ------------ | ---- | ------------------------------------------------------------ |
|
|
|
@@ -72,13 +72,13 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道ID：[点击查看详情](paymentSchema.md) |
|
|
|
| goodsInfo | String(60) | M | 商品信息,在支付页面上显示。 |
|
|
|
-| detailInfo | String(400) | M | 商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该字段进行Base64编码后签名上送。 |
|
|
|
+| detailInfo | String(400) | M | 商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该参数进行Base64编码后签名上送。 |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
| merReserve | String(1024) | O | 商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号等。 |
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.跳转型消费接口响应报文**
|
|
|
+**3.跳转型消费接口响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ------------ | ---- | ------------------------------------------------------------ |
|
|
|
@@ -113,7 +113,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+**2.请求参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
|
|
|
@@ -128,7 +128,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文格式**
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
|
|
|
@@ -162,7 +162,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+**2.请求参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
|
|
|
@@ -180,7 +180,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(3) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文格式**
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| --------- | ---------- | ---- | ---------------------------------------------- |
|
|
|
@@ -212,7 +212,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+**2.请求参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
|
|
|
@@ -227,7 +227,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文格式**
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
|
|
|
@@ -252,13 +252,13 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
预授权接口适用于外卡（包括VISA、万事达、JCB等卡品牌）和银联卡交易。预授权交易不会参与清算，发卡银行会暂时冻结用户资金。
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+**2.请求参数**
|
|
|
|
|
|
- 由通用字段和渠道专属字段组成。凡是上送字段都需参与签名。
|
|
|
+ 由通用参数和渠道专属参数组成。凡是上送参数都需参与签名。
|
|
|
|
|
|
- *渠道专属字段：* [点击查看](preAuthorizationExclusive_CH.md)
|
|
|
+ *渠道专属参数：* [点击查看](preAuthorizationExclusive_CH.md)
|
|
|
|
|
|
- *通用字段：*
|
|
|
+ *通用参数：*
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ------------ | ---- | ------------------------------------------------------------ |
|
|
|
@@ -269,24 +269,18 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| orderAmount | String(12) | M | 订单金额：如 100 元，表示为 100 或 100.00 |
|
|
|
| orderCurrency | String(3) | M | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD" |
|
|
|
| frontURL | String(400) | M | 支付完成后跳转到该地址 |
|
|
|
-| backURL | String(400) | M | 支付结果异步通知到该地址 |
|
|
|
+| backURL | String(400) | M | 支付结果异步通知到该地址。支付成功后，GoAllPay 会以 POST 方式调用 backURL，通知支付结果（JSON）。商户在接收到通知后，需响应字符串“OK”。<br>如果没有收到商户响应“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。 |
|
|
|
| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道ID：[点击这里](paymentSchema.md) |
|
|
|
| goodsInfo | String(60) | M | 商品信息,在支付页面上显示。 |
|
|
|
-| detailInfo | String(400) | M | 商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该字段进行base-64编码后签名上送。 |
|
|
|
+| detailInfo | String(400) | M | 商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该参数进行base64编码后签名上送。 |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
| merReserve | String(1024) | O | 商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号等。 |
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文**
|
|
|
-
|
|
|
- 商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 POST 方式调用 backURL，通知支付结果（JSON）。商户在接收到通知后，需响应字符串“OK”。
|
|
|
-
|
|
|
- 如果没有收到商户返回“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
-
|
|
|
- 推送参数如下表：
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ------------ | ---- | ------------------------------------------------------------ |
|
|
|
@@ -323,7 +317,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+**2.请求参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ------------------------------------------------------ |
|
|
|
@@ -341,7 +335,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文格式**
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ---------------------------------------------- |
|
|
|
@@ -352,7 +346,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
-| paymentSchema | String(10) | M | 渠道ID：FC |
|
|
|
+| paymentSchema | String(10) | M | 渠道ID |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第5章应答码 |
|
|
|
| RespMsg | String(20) | M | 应答消息 |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -374,7 +368,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+**2.请求参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
|
|
|
@@ -390,7 +384,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文格式**
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ---------------------------------------------- |
|
|
|
@@ -415,7 +409,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
对90天之前的交易进行退款，商户无法通过调用联机退款接口处理，需调用该接口发起退款申请，申请成功后我们业务人员会通过人工方式进行处理，处理周期大概在3-5个工作日，退款申请交易经过人工处理后被成功退款，交易才会清算。
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+**2.请求参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
|
|
|
@@ -433,7 +427,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(3) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文格式**
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ---------------------------------------------- |
|
|
|
@@ -444,7 +438,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
-| paymentSchema | String(10) | M | 渠道ID：FC |
|
|
|
+| paymentSchema | String(10) | M | 渠道ID |
|
|
|
| RespCode | String(2) | M | 应答码 00 代表申请已受理 |
|
|
|
| RespMsg | String(20) | M | 应答消息 |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -456,9 +450,15 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|
|
|
**1.接口功能说明**
|
|
|
|
|
|
- 为用户提供绑卡功能，适用于外卡和银联卡交易。
|
|
|
+ 为用户提供签约功能，适用于外卡、银联卡、支付宝本地支付。
|
|
|
+
|
|
|
+**2.请求参数**
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+ 由通用参数和渠道专属参数组成。凡是上送参数都需参与签名。
|
|
|
+
|
|
|
+ *渠道专属参数：* [点击查看](bindCardPayExclusive_CH.md)
|
|
|
+
|
|
|
+ *通用参数：*
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ----------- | ---- | ---------------------------------------------------------- |
|
|
|
@@ -468,7 +468,6 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
|orderCurrency |String(3) |M |订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD"|
|
|
|
| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
| frontURL | String(400) | M | 绑定结果前端跳转地址 |
|
|
|
-| backURL | String(400) | M | 绑定成功后异步通知到该地址 |
|
|
|
| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| paymentSchema | String(10) | M | 渠道ID：[点击这里](paymentSchema.md) |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
@@ -476,7 +475,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文格式**
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ---------- | ---- | ---------------------------------------------------------- |
|
|
|
@@ -496,59 +495,19 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-### 4.11 解约接口
|
|
|
+### 4.11 订阅扣款接口
|
|
|
|
|
|
**1.接口功能说明**
|
|
|
|
|
|
- 解除绑定的卡片
|
|
|
-
|
|
|
-**2.请求报文格式**
|
|
|
-
|
|
|
-| 参数 | 类型 | 属性 | 描述 |
|
|
|
-| ------------- | ---------- | ---- | ---------------------------------------------------------- |
|
|
|
-| version | String(12) | M | 统一填写为“VER000000005” |
|
|
|
-| transType | String(10) | M | 绑卡 "UNBIND" |
|
|
|
-| orderNum | String(60) | M | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
-| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
-| token | String(32) | M | 绑卡时返回的token |
|
|
|
-| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
-| paymentSchema | String(10) | M | 渠道ID：[点击这里](paymentSchema.md) |
|
|
|
-| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
-| tradeFrom | String(20) | M | 场景，绑卡："PAN-BINGDING" |
|
|
|
-| signType | String(10) | M | MD5或SHA256 |
|
|
|
-| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
-
|
|
|
-**3.响应报文格式**
|
|
|
-
|
|
|
-| 参数 | 类型 | 属性 | 描述 |
|
|
|
-| ------------- | ---------- | ---- | ---------------------------------------------------------- |
|
|
|
-| version | String(12) | M | 统一填写为“VER000000005” |
|
|
|
-| transType | String(10) | M | 绑卡 "UNBIND" |
|
|
|
-| orderNum | String(60) | M | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
-| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
-| paymentSchema | String(10) | M | 渠道ID |
|
|
|
-| RespCode | String(2) | M | 应答码 00 代表成功 |
|
|
|
-| RespMsg | String(20) | M | 应答消息 |
|
|
|
-| customerId | String(60) | O | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
-| cardNoTail | String(4) | O | 卡号后四位,渠道为FC时返回 |
|
|
|
-| token | String(32) | O | token |
|
|
|
-| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
-| GWTime | String(14) | M | YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间 |
|
|
|
-| signType | String(10) | M | MD5或SHA256 |
|
|
|
-| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
-
|
|
|
-### 4.12 订阅扣款接口
|
|
|
-
|
|
|
-**1.接口功能说明**
|
|
|
+ 订阅消费，根据绑卡时返回的token，对用户进行扣款
|
|
|
|
|
|
- 绑卡消费支付，根据绑卡时返回的token，对用户进行扣款
|
|
|
+**2.请求参数**
|
|
|
|
|
|
-**2.请求报文格式**
|
|
|
+ 由通用参数和渠道专属参数组成。凡是上送参数都需参与签名。
|
|
|
|
|
|
-
|
|
|
+ *渠道专属参数：* [点击查看](bindCardPayExclusive_CH.md)
|
|
|
|
|
|
- *通用字段：*
|
|
|
+ *通用参数：*
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ------------ | ---- | ------------------------------------------------------------ |
|
|
|
@@ -558,26 +517,21 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| orderNum | String(60) | M | 订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
| orderAmount | String(12) | M | 订单金额：如 100 元，表示为 100 或 100.00 |
|
|
|
| orderCurrency | String(3) | M | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD" |
|
|
|
-| backURL | String(400) | M | 支付结果异步通知到该地址 |
|
|
|
+| backURL | String(400) | M | 支付结果异步通知到该地址。支付成功后，GoAllPay 会以 POST 方式调用 backURL，通知支付结果（JSON）。商户在接收到通知后，需响应字符串“OK”。<br>如果没有收到商户响应“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。 |
|
|
|
| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
| token | String(32) | M | 绑卡时返回的token |
|
|
|
| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
| paymentSchema | String(10) | M | 渠道ID：[点击这里](paymentSchema.md) |
|
|
|
-| detailInfo | String(400) | M | 商品明细。格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该字段进行base-64编码后签名上送。 |
|
|
|
+| goodsInfo | String(60) | M | 商品信息。 |
|
|
|
+| detailInfo | String(400) | M | 商品明细，格式：[{"goods_name":"iPhone X","quantity":"2"},{"goods_name":"iPhone 8","quantity":"4"}]，需对该参数进行base64编码后签名上送。 |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
| tradeFrom | String(20) | M | 场景，绑卡："PAN-BINGDING" |
|
|
|
| merReserve | String(1024) | O | 商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号等。 |
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-**3.响应报文**
|
|
|
-
|
|
|
- 商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 POST 方式调用 backURL，通知支付结果（JSON）。商户在接收到通知后，需响应字符串“OK”。
|
|
|
-
|
|
|
- 如果没有收到商户返回“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
-
|
|
|
- 推送参数如下表：
|
|
|
+**3.响应参数**
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
| ------------- | ------------ | ---- | ------------------------------------------------------------ |
|
|
|
@@ -589,7 +543,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| orderCurrency | String(3) | M | 订单币种：ISO标准。如：人民币填写“CNY”，美元填写"USD" |
|
|
|
| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
-| paymentSchema | String(10) | M | 渠道ID：FC |
|
|
|
+| paymentSchema | String(10) | M | 渠道ID |
|
|
|
| RespCode | String(2) | M | 应答码 00-成功，01-失败。详情见本文档第5章应答码 |
|
|
|
| RespMsg | String(20) | M | 应答消息 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
@@ -599,6 +553,48 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
+### 4.12 解约接口
|
|
|
+
|
|
|
+**1.接口功能说明**
|
|
|
+
|
|
|
+ 解除绑定的卡片
|
|
|
+
|
|
|
+**2.请求参数**
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ------------- | ---------- | ---- | ---------------------------------------------------------- |
|
|
|
+| version | String(12) | M | 统一填写为“VER000000005” |
|
|
|
+| transType | String(10) | M | 绑卡 "UNBIND" |
|
|
|
+| orderNum | String(60) | M | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
+| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
+| token | String(32) | M | 绑卡时返回的token |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
+| paymentSchema | String(10) | M | 渠道ID：[点击这里](paymentSchema.md) |
|
|
|
+| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
+| tradeFrom | String(20) | M | 场景，绑卡："PAN-BINGDING" |
|
|
|
+| signType | String(10) | M | MD5或SHA256 |
|
|
|
+| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
+
|
|
|
+**3.响应参数**
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ------------- | ---------- | ---- | ---------------------------------------------------------- |
|
|
|
+| version | String(12) | M | 统一填写为“VER000000005” |
|
|
|
+| transType | String(10) | M | 绑卡 "UNBIND" |
|
|
|
+| orderNum | String(60) | M | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
+| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
+| paymentSchema | String(10) | M | 渠道ID |
|
|
|
+| RespCode | String(2) | M | 应答码 00 代表成功 |
|
|
|
+| RespMsg | String(20) | M | 应答消息 |
|
|
|
+| customerId | String(60) | O | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
+| cardNoTail | String(4) | O | 卡号后四位,渠道为FC时返回 |
|
|
|
+| token | String(32) | O | token |
|
|
|
+| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
+| GWTime | String(14) | M | YYYYMMDDHHMMSS，为 GW 时间，目前为本地交易时间 |
|
|
|
+| signType | String(10) | M | MD5或SHA256 |
|
|
|
+| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
+
|
|
|
## 5.应答码
|
|
|
|
|
|
| 应答码 | 描 述 |
|
|
|
@@ -609,7 +605,7 @@ signature: 1e0f24d39cdc8236d17a5f6f17672611
|
|
|
| 61 | 超过限额 |
|
|
|
| U1 | 商户号不存在 |
|
|
|
| U2 | 签名错误 |
|
|
|
-| U3 | 报文被篡改 |
|
|
|
+| U3 | 请求被篡改 |
|
|
|
| U4 | 缺失参数 |
|
|
|
| U5 | 无效的参数 |
|
|
|
| U6 | 重复的订单号 |
|
