|
|
@@ -68,7 +68,7 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
|
|
|
3.跳转型消费接口响应报文
|
|
|
|
|
|
- 商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果。商户在接收到通知后，需返回“OK”。
|
|
|
+ 商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果（JSON）。商户在接收到通知后，需返回“OK”。
|
|
|
|
|
|
如果没有收到商户返回“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
|
|
|
@@ -272,7 +272,7 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
|
|
|
3.响应报文
|
|
|
|
|
|
- 商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果。商户在接收到通知后，需返回“OK”。
|
|
|
+ 商户需要提供一个 http/https 协议的接口，包含在参数里传递给GoAllPay，即 backURL。GoAllPay 服务器在支付完成后，会以 Post 方式调用 backURL，通知支付结果（JSON）。商户在接收到通知后，需返回“OK”。
|
|
|
|
|
|
如果没有收到商户返回“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 30, 180, 1800, 3600, 7200, 14400, 14400]，单位为秒。
|
|
|
|
|
|
@@ -442,7 +442,7 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-### 4.10 外卡绑卡接口
|
|
|
+### 4.10 签约接口
|
|
|
|
|
|
1.接口功能说明
|
|
|
|
|
|
@@ -455,36 +455,16 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
| version | String(12) | M | 统一填写为“VER000000005” |
|
|
|
| transType | String(10) | M | 绑卡 "BIND" |
|
|
|
| orderNum | String(60) | M | 绑卡订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
+| 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 | 渠道代码:FC |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
+| paymentSchema | String(10) | M | 渠道代码 |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-绑卡分两种模式
|
|
|
-
|
|
|
-(1) 用户在商户平台选择添加卡，然后跳转至GoAllPay的绑卡页面，用户在此页面输入卡号信息.绑卡失败,则返失败通知给商户；绑卡成功，返一个“token+customer ID+卡号后四位”给商户。
|
|
|
-
|
|
|
- 方式一专属字段
|
|
|
-
|
|
|
-| 参数 | 类型 | 属性 | 描述 |
|
|
|
-| --------- | ------ | ---- | ---- |
|
|
|
-| tradeFrom | String | M | "H5" |
|
|
|
-
|
|
|
-(2)商户自己收集卡号信息通过API送到GoAllPay网关.
|
|
|
-
|
|
|
- 方式二专属字段
|
|
|
-
|
|
|
-| 参数 | 类型 | 属性 | 描述 |
|
|
|
-| ---------- | ------ | ---- | ----------------- |
|
|
|
-| tradeFrom | String | M | "API" |
|
|
|
-| cardno | String | M | 卡号 |
|
|
|
-| cvv2 | String | M | cvv2 |
|
|
|
-| ExpiryDate | String | M | 有效期:格式 MM/YY |
|
|
|
-
|
|
|
3.响应报文格式
|
|
|
|
|
|
| 参数 | 类型 | 属性 | 描述 |
|
|
|
@@ -493,19 +473,19 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
| transType | String(10) | M | 绑卡 "BIND" |
|
|
|
| orderNum | String(60) | M | 绑卡订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
| transID | String(32) | M | GW 系统生成的交易 ID，每笔交易保持唯一 |
|
|
|
-| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
-| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
+| paymentSchema | String(10) | M | 渠道代码 |
|
|
|
| RespCode | String(2) | M | 应答码 00 代表成功 |
|
|
|
| RespMsg | String(20) | M | 应答消息 |
|
|
|
| token | String(32) | O | 应答码为 00时返回 |
|
|
|
| customerId | String(60) | O | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
-| cardNoTail | String(4) | O | 卡号后四位 |
|
|
|
+| cardNoTail | String(4) | O | 渠道为FC时返回 ,卡号后四位 |
|
|
|
| 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 外卡解绑接口
|
|
|
+### 4.11 解约接口
|
|
|
|
|
|
1.接口功能说明
|
|
|
|
|
|
@@ -518,10 +498,11 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
| version | String(12) | M | 统一填写为“VER000000005” |
|
|
|
| transType | String(10) | M | 绑卡 "UNBIND" |
|
|
|
| orderNum | String(60) | M | 解绑订单号：商户自行定义，需保证同一商户号下订单号不能重复 |
|
|
|
+| orderCurrency | String(3) | M | 订单币种：ISO标准 如：人民币填写“CNY”,美元填写"USD" |
|
|
|
| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
| token | String(32) | M | 绑卡时返回的token |
|
|
|
-| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
-| paymentSchema | String(10) | M | 渠道代码:FC |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
+| paymentSchema | String(10) | M | 渠道代码 |
|
|
|
| transTime | String(14) | M | 交易时间，格式："yyyyMMddHHmmss" |
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
@@ -534,19 +515,19 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
| 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 | 渠道代码：FC |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
+| paymentSchema | String(10) | M | 渠道代码 |
|
|
|
| RespCode | String(2) | M | 应答码 00 代表成功 |
|
|
|
| RespMsg | String(20) | M | 应答消息 |
|
|
|
| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
-| cardNoTail | String(4) | M | 卡号后四位 |
|
|
|
-| token | String(32) | M | tokens |
|
|
|
+| cardNoTail | String(4) | M | 卡号后四位,渠道为FC时返回 |
|
|
|
+| token | String(32) | M | 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 绑卡消费接口
|
|
|
+### 4.12 订阅扣款接口
|
|
|
|
|
|
1.接口功能说明
|
|
|
|
|
|
@@ -567,9 +548,9 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
| backURL | String(400) | M | 支付结果异步通知到该地址 |
|
|
|
| customerId | String(60) | M | 用户ID: 商户自行定义，需保证同一商户号下不同用户不能重复 |
|
|
|
| token | String(32) | M | 绑卡时返回的token |
|
|
|
-| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
+| merID | String(15) | M | 商户 ID，由 GoAllPay 分配 |
|
|
|
| acqID | String(11) | M | 收单行 ID "99020344" |
|
|
|
-| paymentSchema | String(10) | M | 渠道代码：FC |
|
|
|
+| paymentSchema | String(10) | 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 | 商户预留内容，可传任意内容，如购买商品信息、员号等，但不要传特殊符号，如逗号等。 |
|
|
|
@@ -598,8 +579,6 @@ GoAllPay 为客户提供统一的API接入，以帮助客户实现快速、安
|
|
|
| signType | String(10) | M | MD5或SHA256 |
|
|
|
| signature | String(32) | M | 采用 MD5或SHA256 签名 |
|
|
|
|
|
|
-###
|
|
|
-
|
|
|
## 5.渠道专属配置
|
|
|
|
|
|
### 5.1 WX渠道
|
|
|
@@ -934,6 +913,29 @@ CVC: 737
|
|
|
| --------- | ------ | ---- | ---- |
|
|
|
| tradeFrom | String | M | "H5" |
|
|
|
|
|
|
+#### 5.10.2 签约绑卡支付
|
|
|
+
|
|
|
+绑卡分两种模式
|
|
|
+
|
|
|
+(1) 用户在商户平台选择添加卡，然后跳转至GoAllPay的绑卡页面，用户在此页面输入卡号信息.绑卡失败,则返失败通知给商户；绑卡成功，返一个“token+customer ID+卡号后四位”给商户。
|
|
|
+
|
|
|
+ 方式一专属字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| --------- | ------ | ---- | ---- |
|
|
|
+| tradeFrom | String | M | "H5" |
|
|
|
+
|
|
|
+(2)商户自己收集卡号信息通过API送到GoAllPay网关.
|
|
|
+
|
|
|
+ 方式二专属字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ---------- | ------ | ---- | ----------------- |
|
|
|
+| tradeFrom | String | M | "API" |
|
|
|
+| cardno | String | M | 卡号 |
|
|
|
+| cvv2 | String | M | cvv2 |
|
|
|
+| ExpiryDate | String | M | 有效期:格式 MM/YY |
|
|
|
+
|
|
|
```javascript
|
|
|
测试卡：
|
|
|
|
|
|
@@ -962,7 +964,6 @@ CVV2: 123
|
|
|
| bankCode | String | M | 银行代码 |
|
|
|
|
|
|
```javascript
|
|
|
-
|
|
|
测试卡的信息：
|
|
|
FPX Test Card
|
|
|
Payment ID : 3
|
|
|
@@ -982,6 +983,78 @@ Password : 1234
|
|
|
| --------- | ------ | ---- | ------- |
|
|
|
| tradeFrom | String | M | "H5" |
|
|
|
|
|
|
+### 5.13 PO渠道
|
|
|
+
|
|
|
+#### 5.13.1 H5支付
|
|
|
+
|
|
|
+ 消费接口专属字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ----------------- | ------ | ---- | ------------------------------------------------------------ |
|
|
|
+| tradeFrom | String | M | "H5" |
|
|
|
+| countrycode | String | M | The 2-letter ISO country code of the country in which the payment instrument is issued/operated (e.g. DE). For details see [payment method specific documentation](https://git.allpayx.com/OpenAPI/common/src/master/countrycode.md). |
|
|
|
+| accountholdername | String | M | The account holder - minimum of 3 characters, up to 100 charac- ters. |
|
|
|
+| tag | String | M | 取值如下：directpay, boleto, webpay, trustpay, skrill, singpost, sepaddmodela, safetypay, qiwi, p24, poli, paysafecard, mybank, itau, ideal, hipercard, giropay, eps, enets, dragonpay, bancodobrasil, baloto, aura, payu |
|
|
|
+
|
|
|
+##### 5.13.1.1 当 tag 为 paysafecard 时，还需另外增加下面字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ----------- | ------ | ---- | ------------------------------------------------------------ |
|
|
|
+| consumerref | String | M | Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} |
|
|
|
+
|
|
|
+##### 5.13.1.2 当 tag 为 aura, baloto, bancodobrasil, boleto, hipercard, itau, webpay 时，还需另外增加下面字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ----------- | ------ | ---- | ------------------------------------------------------------ |
|
|
|
+| consumerref | String | M | Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} |
|
|
|
+| nationalid | String | M | Consumer’s national id (up to 30 characters) |
|
|
|
+| email | String | M | RFC compliant email address of the account holder |
|
|
|
+| address | String | M | Consumer's address |
|
|
|
+| zipcode | String | M | Consumer's zip/postal code |
|
|
|
+| dob | String | O | Date of birth, format YYYYMMDD |
|
|
|
+
|
|
|
+##### 5.13.1.3 当 tag 为 dragonpay, enets, singpost 时，还需另外增加下面字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ----- | ------ | ---- | ------------------------------------------------------ |
|
|
|
+| email | String | M | RFC compliant email address of the account holder |
|
|
|
+| phone | String | M | Valid international phone number of the account holder |
|
|
|
+
|
|
|
+##### 5.13.1.4 当 tag 为 giropay, directpay 时，还需另外增加下面字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ---- | ------ | ---- | ----------------------------------------------------------- |
|
|
|
+| bic | String | O | Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank |
|
|
|
+
|
|
|
+##### 5.13.1.5 当 tag 为 payu, p24, safetypay 时，还需另外增加下面字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ----- | ------ | ---- | ------------------------------------------------- |
|
|
|
+| email | String | M | RFC compliant email address of the account holder |
|
|
|
+
|
|
|
+##### 5.13.1.6 当 tag 为 qiwi 时，还需另外增加下面字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ----------- | ------ | ---- | ------------------------------------------------------------ |
|
|
|
+| mobilephone | String | M | Valid international Russian mobile phone number identifying the QIWI destination account to pay out to (excluding plus sign or any other international prefixes, including a leading 7 for Russia, 11 digits in total, e.g. 71234567890). |
|
|
|
+| siteid | String | M | Unique site identifier, forwarded to qiwi. Required for clients serving multiple points of sale. |
|
|
|
+
|
|
|
+##### 5.13.1.7 当 tag 为 skrill 时，还需另外增加下面字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ------- | ------ | ---- | ------------------------------------------------- |
|
|
|
+| email | String | O | RFC compliant email address of the account holder |
|
|
|
+| address | String | O | Consumer's address |
|
|
|
+| zipcode | String | O | Consumer's zip/postal code |
|
|
|
+| city | String | O | Consumer’s city |
|
|
|
+
|
|
|
+##### 5.13.1.8 当 tag 为 sepaddmodela 时，还需另外增加下面字段
|
|
|
+
|
|
|
+| 参数 | 类型 | 属性 | 描述 |
|
|
|
+| ----- | ------ | ---- | ------------------------------------------------- |
|
|
|
+| email | String | M | RFC compliant email address of the account holder |
|
|
|
+| iban | String | M | Valid IBAN |
|
|
|
+
|
|
|
## 6.应答码
|
|
|
|
|
|
| 应答码 | 描 述 |
|
