benson 4 years ago
parent
commit
0416626a74
2 changed files with 145 additions and 38 deletions
  1. 143 37
      AllPay_Integration_Specification_CH.md
  2. 2 1
      paymentSchema.md

+ 143 - 37
AllPay_Integration_Specification_CH.md

@@ -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    | 商户预留内容,可传任意内容,如购买商品信息、员号等,但不要传特殊符号,如逗号等。 |
@@ -934,6 +915,31 @@ 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
 测试卡:
 
@@ -982,6 +988,106 @@ Password : 1234
 | --------- | ------ | ---- | ------- |
 | tradeFrom | String | M    | "H5" |
 
+
+
+
+
+### 5.13 PO渠道
+
+#### 5.13.1  
+
+ 消费接口专属字段
+
+| 参数              | 类型   | 属性 | 描述                                                         |
+| ----------------- | ------ | ---- | ------------------------------------------------------------ |
+| 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. |
+| accountholdername | String | M    | The account holder - minimum of 3 characters, up to 100 charac- ters. |
+| tag               | String | M    | eps, giropay, p24, astropaycard, astropaydirect, aura, baloto, bancodobrasil, bitpay,  boleto, directpay, dragonpay, enets, ideal, itau, mybank, paysbuy, payu, poli, qiwi, safetypay,                        sepadirectdebit, singpost, skrill, trustpay, webpay |
+
+## 
+
+当 tag 为 astropaycard,astropaydirect,paysafecard时 需要增加下面字段
+
+| 参数        | 类型   | 属性 | 描述                                                         |
+| ----------- | ------ | ---- | ------------------------------------------------------------ |
+| consumerref | String | M    | Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} |
+
+
+
+当 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                               |
+
+
+
+当 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 |
+
+
+
+当 tag 为 giropay,directpay时 需要增加下面字段
+
+| 参数 | 类型   | 属性 | 描述                                                        |
+| ---- | ------ | ---- | ----------------------------------------------------------- |
+| bic  | String | O    | Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank |
+
+
+
+当 tag 为 payu,p24,safetypay时 需要增加下面字段
+
+| 参数  | 类型   | 属性 | 描述                                              |
+| ----- | ------ | ---- | ------------------------------------------------- |
+| email | String | M    | RFC compliant email address of the account holder |
+
+
+
+当 tag 为 qiwi,p24,safetypay时 需要增加下面字段
+
+
+
+| 参数        | 类型   | 属性 | 描述                                                         |
+| ----------- | ------ | ---- | ------------------------------------------------------------ |
+| 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. |
+
+
+
+当 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                                   |
+
+
+
+当 tag 为 sepaddmodela时 需要增加下面字段
+
+| 参数  | 类型   | 属性 | 描述                                              |
+| ----- | ------ | ---- | ------------------------------------------------- |
+| email | String | O    | RFC compliant email address of the account holder |
+| iban  | String | O    | Valid IBAN                                        |
+
+
+
 ## 6.应答码 
 
 | 应答码 | 描  述      |

+ 2 - 1
paymentSchema.md

@@ -13,4 +13,5 @@ Serial number |Channel name  |Channel ID|Remark
  10 | Alipay HK |APHK| Alipay HK 
  11 | RevPay |RevPay| Malaysia Online Banking 
  12 | Gcash |Gcash| Alipay Philippine wallet 
- 
+ 13 | PO |PO| PO 
+