## 渠道专属参数
### 目录:
- [1. WX渠道](#1-wx渠道)
- [1.1 二维码无跳转模式](#11-二维码无跳转模式)
- [1.2 二维码跳转模式](#12-二维码跳转模式)
- [1.3 公众号支付](#13-公众号支付)
- [1.4 小程序支付](#14-小程序支付)
- [1.5 APP支付](#15-app支付)
- [2. AP渠道](#2-ap渠道)
- [2.1 WebSite支付](#21-website支付)
- [2.2 H5支付](#22-h5支付)
- [2.3 APP支付](#23-app支付)
- [2.4 二维码无跳转模式](#24-二维码无跳转模式)
- [2.5 小程序支付](#25-小程序支付)
- [3. UP渠道](#3-up渠道)
- [3.1 H5支付](#31-h5支付)
- [3.2 APP支付](#32-app支付)
- [3.3 二维码无跳转模式](#33-二维码无跳转模式)
- [3.4 Express Pay](#34-express-pay)
- [4. Apple Pay渠道](#4-apple-pay渠道)
- [4.1 APP支付](#41-app支付)
- [5. FC渠道](#5-fc渠道)
- [5.1 H5支付](#51-h5支付)
- [5.1.1 CIL外卡](#511-cil外卡)
- [5.1.2 SN外卡](#512-sn外卡)
- [5.1.3 TL外卡](#513-tl外卡)
- [5.1.4 ICBC外卡](#514-icbc外卡)
- [5.1.5 RDP外卡](#515-rdp外卡)
- [5.1.6 VT外卡](#516-vt外卡)
- [5.2 后台支付(适用于SN和TL外卡)](#52-后台支付适用于sn和tl外卡)
- [5.3 后台支付(适用于外卡3DS)](#53-后台支付适用于外卡3ds)
- [6. RevPay渠道](#6-revpay渠道)
- [6.1 H5支付](#61-h5支付)
- [7. AliPayPlus渠道](#7-alipayplus渠道)
- [7.1 H5支付](#71-h5支付)
- [7.2 WebSite支付](#72-website支付)
- [7.3 二维码无跳转模式](#73-二维码无跳转模式)
- [7.4 APP支付](#74-app支付)
- [7.5 小程序支付](#75-小程序支付)
- [8. PO渠道](#8-po渠道)
- [8.1 H5支付](#81-h5支付)
- [9. India_Netbanking渠道](#9-india_netbanking渠道)
- [9.1 H5支付](#91-h5支付)
- [10. PAYPAL渠道](#10-paypal渠道)
- [10.1 H5支付](#101-h5支付)
- [11. Neosurf渠道](#11-neosurf渠道)
- [11.1 H5支付](#111-h5支付)
- [12. DNC渠道](#12-dnc渠道)
- [12.1 H5支付](#121-h5支付)
- [12.2 后台支付](#122-后台支付)
- [13. Ksher渠道](#13-ksher渠道)
- [13.1 H5支付](#131-h5支付)
- [14. FPX渠道](#14-fpx渠道)
- [14.1 H5支付](#141-h5支付)
- [15. India_UPI渠道](#15-india_upi渠道)
- [15.1 H5支付](#151-h5支付)
- [16. Boleto渠道](#16-boleto渠道)
- [16.1 H5支付](#161-h5支付)
- [17. Baloto渠道](#17-baloto渠道)
- [17.1 H5支付](#171-h5支付)
- [18. PIX渠道](#18-pix渠道)
- [18.1 H5支付](#181-h5支付)
- [19. PSE渠道](#19-pse渠道)
- [19.1 H5支付](#191-h5支付)
- [20. Webpay渠道](#20-webpay渠道)
- [20.1 H5支付](#201-h5支付)
- [21. OXXO渠道](#21-oxxo渠道)
- [21.1 H5支付](#211-h5支付)
- [22. SPEI渠道](#22-spei渠道)
- [22.1 H5支付](#221-h5支付)
- [23. PagoEfectivo渠道](#23-pagoefectivo渠道)
- [23.1 H5支付](#231-h5支付)
- [24. Interbank渠道](#24-interbank渠道)
- [24.1 H5支付](#241-h5支付)
- [25 PayNow渠道](#25-paynow渠道)
- [25.1 二维码无跳转模式](#251-二维码无跳转模式)
- [26. P24渠道](#26-p24渠道)
- [26.1 H5支付](#261-h5支付)
- [27. Paysafecard渠道](#27-paysafecard渠道)
- [27.1 H5支付](#271-h5支付)
- [28. IDEAL渠道](#28-ideal渠道)
- [28.1 H5支付](#281-h5支付)
### 1. WX渠道
#### 1.1 二维码无跳转模式
该模式返回生成二维码的字符串,商户需要自己生成二维码。
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "QRCODE" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| code_url | String | 否 | 二维码字符串 |
#### 1.2 二维码跳转模式
该模式会为商户跳转到GoAllPay生成好的二维码页面,无需商户自己生成。
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ------- |
| tradeFrom | String | 是 | "QUICK" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
#### 1.3 公众号支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ------- |
| tradeFrom | String | 是 | "JSAPI" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 支付URL |
#### 1.4 小程序支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---------- |
| tradeFrom | String | 是 | "APPLET" |
| openid | String | 是 | 微信openid |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ------------------------------------------------------ |
| sdk_params | Object | 否 | 小程序支付所需参数 |
将上述返回数据放入微信小程序支付接口,即可调起支付,具体方法请参考微信官方小程序API。
#### 1.5 APP支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ----- |
| tradeFrom | String | 是 | "APP" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | --------------------------------------------------------- |
| tn | String | 否 | 交易流水号,作为调起 sdk 支付的参数 |
获取到tn后,根据[APP对接文档](AllPay_Integration_Specification_CH.md#6-app模式对接文档)调用SDK进行支付。
### 2. AP渠道
#### 2.1 WebSite支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ----- |
| tradeFrom | String | 是 | "WEB" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
#### 2.2 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ------- |
| tradeFrom | String | 是 | "JSAPI" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 支付URL |
#### 2.3 APP支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ----- |
| tradeFrom | String | 是 | "APP" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | --------------------------------------------------------- |
| tn | String | 否 | 交易流水号,作为调起 sdk 支付的参数 |
获取到tn后,根据[APP对接文档](AllPay_Integration_Specification_CH.md#6-app模式对接文档)调用SDK进行支付。
#### 2.4 二维码无跳转模式
该模式返回生成二维码的字符串,商户需要自己生成二维码。
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "QRCODE" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ---------------------------------- |
| code_url | String | 否 | 二维码字符串 |
#### 2.5 小程序支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "APPLET" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ---------------------------------------- |
| sdk_params | String | 否 | 小程序支付所需参数 |
将上述返回数据放入支付宝小程序支付接口,即可调起支付,具体方法,参考支付宝官方小程序API。
### 3. UP渠道
#### 3.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
#### 3.2 APP支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ----- |
| tradeFrom | String | 是 | "APP" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------------------------------- |
| tn | String | 否 | 交易流水号,作为调起 sdk 支付的参数 |
获取到tn后,根据[APP对接文档](AllPay_Integration_Specification_CH.md#6-app模式对接文档)调用SDK进行支付。
#### 3.3 二维码无跳转模式
该模式返回生成二维码的字符串,商户需要自己生成二维码。
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "QRCODE" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ---------------------------------- |
| code_url | String | 否 | 二维码字符串 |
#### 3.4 Express Pay
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "PAN-PRESENT" |
| cardno | String | 是 | 卡号 |
| cvv | String | 是 | cvv2 |
| expired | String | 是 | 有效期 YYMM |
```javascript
银联测试卡:
Credit card:6250947000000014
mobile:+852 11112222
cvn2: 123
exp date: month 12 year 33
SMS Code on PC: 111111
SMS Code on Mobile: 123456
Debit card:6223164991230014
mobile:13012345678
PIN: 111111
cvn2: 123
exp date: month 12 year 33
SMS Code on PC:111111
SMS Code on Mobile:123456
Credit card:8171999927660000
mobile:+852 11112222
cvn2: 123
exp date: month 12 year 30
SMS Code on PC: 111111
SMS Code on Mobile: 123456
```
### 4. Apple Pay渠道
#### 4.1 APP支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ----- |
| tradeFrom | String | 是 | "APP" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------------------------------- |
| tn | String | 否 | 交易流水号,作为调起 sdk 支付的参数 |
获取到tn后,根据[APP对接文档](AllPay_Integration_Specification_CH.md#6-app模式对接文档)调用SDK进行支付。
### 5. FC渠道
#### 5.1 H5支付
##### 5.1.1 CIL外卡
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
```javascript
CIL测试卡:
卡号: 4761340000000019
有效期: 1217
CVV2: 830
卡号: 5204730000002555
有效期: 1225
CVV2: 123
```
##### 5.1.2 SN外卡
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| billCountry | String | 否 | 账单国家/地区,2位国家码,如:US |
| billState | String | 否 | 账单州/省/邦,2位编码,如:CA |
| billCity | String | 否 | 账单城市 |
| billStreet | String | 否 | 账单地址 |
| billEmail | String | 否 | 账单邮箱 |
| billPostalCode | String | 否 | 账单邮编 |
| logisticsCountry | String | 否 | 物流国家/地区,2位国家码,如:US |
| logisticsState | String | 否 | 物流州/省/邦,2位编码,如:CA |
| logisticsCity | String | 否 | 物流城市 |
| logisticsPostalCode | String | 否 | 物流邮编 |
| logisticsEmail | String | 否 | 物流邮箱 |
```javascript
SN测试卡:
卡号: 5309289710447190
有效期: 0825
CVV2: 900
```
##### 5.1.3 TL外卡
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| ------------------- | ------ | ---- | -------------------------------- |
| tradeFrom | String | 是 | "H5" |
| email | String | 否 | 持卡人电子邮件地址 |
| logisticsCountry | String | 是 | 物流国家/地区,2位国家码,如:US |
| logisticsState | String | 是 | 物流州/省/邦,2位编码,如:CA |
| logisticsCity | String | 是 | 物流城市 |
| logisticsPostalCode | String | 是 | 物流邮编 |
| logisticsPhone | String | 是 | 物流电话 |
```javascript
TL测试卡:
卡号: 4012001037141112
有效期: 1227
CVV2: 212
卡号: 5204740000001002
有效期: 1227
CVV2: 212
```
##### 5.1.4 ICBC外卡
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ------------------------------------------------------------ |
| tradeFrom | String | 是 | "H5" |
| ieu | String | 是 | 语言标示。
葡语: pt-BR
英语: en-US
简体中文: zh-CN
繁体中文: zh-TW
必须严格按照文档描述大小写上送。 |
**ICBC测试卡:**
点击卡号获取短信验证码
卡号1:[4574108900117879](https://gwinternet.icbcmo.site/sms-inq-svc/v1/inqByCardNo?cardNo=4574108900117879)
卡号2:[4377651201379895](https://gwinternet.icbcmo.site/sms-inq-svc/v1/inqByCardNo?cardNo=4377651201379895)
卡号3:[5440163901773005](https://gwinternet.icbcmo.site/sms-inq-svc/v1/inqByCardNo?cardNo=5440163901773005)
卡号4:[5305063800002981](https://gwinternet.icbcmo.site/sms-inq-svc/v1/inqByCardNo?cardNo=5305063800002981)
卡号5:[5305066800004683](https://gwinternet.icbcmo.site/sms-inq-svc/v1/inqByCardNo?cardNo=5305066800004683)
卡号6:[5305063800001223](https://gwinternet.icbcmo.site/sms-inq-svc/v1/inqByCardNo?cardNo=5305063800001223)
##### 5.1.5 RDP外卡
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
```javascript
RDP测试卡:
卡号: 4111111111111111
有效期: 122027
CVV2: 123
卡号: 5200000900007102
有效期: 122027
CVV2: 123
```
##### 5.1.6 VT外卡
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
```javascript
VT测试卡:
卡号: 4111111111111111
有效期: 1227
CVV2: 123
```
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
#### 5.2 后台支付(适用于SN和TL外卡)
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "API" |
| cardNo | String | 是 | 卡号 |
| expDate | String | 是 | 有效期,格式:MMYY |
| cvnCode | String | 是 | CVN |
| lastName | String | 是 | Last Name |
| firstName | String | 是 | First Name |
| billCountry | String | 否 | 账单国家/地区,2位国家码,如:US |
| billState | String | 否 | 账单州/省/邦,2位编码,如:CA |
| billCity | String | 否 | 账单城市 |
| billStreet | String | 否 | 账单地址 |
| billEmail | String | 否 | 账单邮箱 |
| billPostalCode | String | 否 | 账单邮编 |
| billPhone | String | 否 | 账单电话 |
| logisticsCountry | String | 否 | 物流国家/地区,2位国家码,如:US |
| logisticsState | String | 否 | 物流州/省/邦,2位编码,如:CA |
| logisticsCity | String | 否 | 物流城市 |
| logisticsPostalCode | String | 否 | 物流邮编 |
| logisticsEmail | String | 否 | 物流邮箱 |
| logisticsPhone | String | 否 | 物流电话 |
| pcToken2 | String | 否 | 设备指纹 |
| forterTokenCookie | String | 否 | 客户端埋点 |
#### 5.3 后台支付(适用于外卡3DS)
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "API-3DS" |
| cardNo | String | 是 | 卡号 |
| expDate | String | 是 | 有效期,格式:MMYY |
| cvnCode | String | 是 | CVN |
| lastName | String | 是 | Last Name |
| firstName | String | 是 | First Name |
| billCountry | String | 否 | 账单国家/地区,2位国家码,如:US |
| billState | String | 否 | 账单州/省/邦,2位编码,如:CA |
| billCity | String | 否 | 账单城市 |
| billStreet | String | 否 | 账单地址 |
| billEmail | String | 条件 | 账单邮箱,RDP必填 |
| billPostalCode | String | 否 | 账单邮编 |
| billPhone | String | 否 | 账单电话 |
| logisticsCountry | String | 否 | 物流国家/地区,2位国家码,如:US |
| logisticsState | String | 否 | 物流州/省/邦,2位编码,如:CA |
| logisticsCity | String | 否 | 物流城市 |
| logisticsPostalCode | String | 否 | 物流邮编 |
| logisticsEmail | String | 否 | 物流邮箱 |
| logisticsPhone | String | 否 | 物流电话 |
| pcToken2 | String | 否 | 设备指纹 |
| forterTokenCookie | String | 否 | 客户端埋点 |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 3DS URL |
### 6. RevPay渠道
#### 6.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "H5" |
| sub_brand_code | String | 是 | "boost", "grabpay", "touchngo", "maybankQR" 选其中一个上送 |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 7. AliPayPlus渠道
#### 7.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| -------------- | ------ | ---- | ------------------------------------------------------------ |
| tradeFrom | String | 是 | "H5" |
| sub_brand_code | String | 是 | "alipay_cn","gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng", "bpi","connect_wallet","rabbit_line_pay" 选其中一个上送 |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
#### 7.2 WebSite支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ----- |
| tradeFrom | String | 是 | "WEB" |
| sub_brand_code | String | 是 | "alipay_cn","gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng", "bpi","connect_wallet","rabbit_line_pay" 选其中一个上送 |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
#### 7.3 二维码无跳转模式
该模式返回生成二维码的字符串,商户需要自己生成二维码。
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "QRCODE" |
| sub_brand_code | String | 是 | "alipay_cn","gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng", "bpi","connect_wallet","rabbit_line_pay" 选其中一个上送 |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| code_url | String | 否 | 二维码字符串 |
#### 7.4 APP支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ----- |
| tradeFrom | String | 是 | "APP" |
| sub_brand_code | String | 是 | "alipay_cn","gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng", "bpi","connect_wallet","rabbit_line_pay" 选其中一个上送 |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | --------------------------------------------------------- |
| tn | String | 否 | 交易流水号,作为调起 sdk 支付的参数 |
获取到tn后,根据[APP对接文档](AllPay_Integration_Specification_CH.md#6-app模式对接文档)调用SDK进行支付。
#### 7.5 小程序支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "APPLET" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ---------------------------------------- |
| sdk_params | String | 否 | 小程序支付所需参数 |
将上述返回数据放入支付宝小程序支付接口,即可调起支付,具体方法,参考支付宝官方小程序API。
### 8. PO渠道
#### 8.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| ----------------- | ------ | ---- | ------------------------------------------------------------ |
| tradeFrom | String | 是 | "H5" |
| tag | String | 是 | 选项:directpay, boleto, webpay, trustpay, skrill, sepaddmodela, safetypay, qiwi, p24, poli, paysafecard, mybank, itau, ideal, hipercard, giropay, eps, enets, dragonpay, bancodobrasil, baloto, aura, payu, bcmc, santander, pagofacil, rapipago, konbini, payeasy, doku, ovo, grabpayotp, klarna |
| countrycode | String | 是 | 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](countrycode.md). |
| accountholdername | String | 是 | The account holder - minimum of 3 characters, up to 100 characters. |
**当 tag 为 paysafecard 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ----------- | ------ | ---- | ------------------------------------------------------------ |
| consumerref | String | 否 | 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 | 是 | Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} |
| nationalid | String | 是 | Consumer’s national id (up to 30 characters) |
| email | String | 是 | RFC compliant email address of the account holder |
| address | String | 是 | Consumer's address |
| zipcode | String | 是 | Consumer's zip/postal code |
| dob | String | 否 | Date of birth, format YYYYMMDD |
**当 tag 为 dragonpay, enets 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ----- | ------ | ---- | ------------------------------------------------------ |
| email | String | 是 | RFC compliant email address of the account holder |
| phone | String | 是 | Valid international phone number of the account holder |
**当 tag 为 giropay, directpay 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ---- | ------ | ---- | ----------------------------------------------------------- |
| bic | String | 否 | Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank |
**当 tag 为 payu, p24, safetypay 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ----- | ------ | ---- | ------------------------------------------------- |
| email | String | 是 | RFC compliant email address of the account holder |
**当 tag 为 qiwi 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ----------- | ------ | ---- | ------------------------------------------------------------ |
| mobilephone | String | 是 | 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 | 是 | Unique site identifier, forwarded to qiwi. Required for clients serving multiple points of sale. |
**当 tag 为 skrill 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ------- | ------ | ---- | ------------------------------------------------- |
| email | String | 否 | RFC compliant email address of the account holder |
| address | String | 否 | Consumer's address |
| zipcode | String | 否 | Consumer's zip/postal code |
| city | String | 否 | Consumer’s city |
**当 tag 为 sepaddmodela 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ----- | ------ | ---- | ------------------------------------------------- |
| email | String | 是 | RFC compliant email address of the account holder |
| iban | String | 是 | Valid IBAN |
**当 tag 为 bcmc 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ----- | ------ | ---- | ------------------------------------------------- |
| BEPURL | String | 否 | Trigger URL for mobile payment options in the form BEP://1BC.GIROGATE.DE/BCMC/123456789$ICAE3BUIH5P9U53Y5HKA9CRT (contrived example). |
**当 tag 为 santander, pagofacil, rapipago 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ----- | ------ | ---- | ------------------------------------------------- |
| nationalid | String | 是 | Consumer’s national id (up to 30 characters) |
| consumerref | String | 否 | Unique reference identifying the consumer, has to satisfy the following regular expression: [A-Za-z0-9.%,&/+*$-]{1,20} |
| email | String | 是 | RFC compliant email address of the account holder |
**当 tag 为 konbini, payeasy 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ----- | ------ | ---- | ------------------------------------------------- |
| phone | String | 是 | Consumer phone number without hyphens, country code or other characters (single-byte alphanumeric; must be between 10-11 digits) |
| email | String | 是 | RFC compliant email address of the account holder|
| iteminfo | String | 是 | Information about the item(s) being purchased, displayed on the payment page (up to 22 characters) |
**当 tag 为 doku, ovo 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ------------------------------------------------------------ |
| email | String | 是 | RFC compliant email address of the account holder |
| orderitems | String | 是 | The list of items being purchased formatted as a JSON array. Allowed characters: alphanumeric, blank space, a hyphen, underscore, and dot.
Each item contains the following fields:
• name: The name of the item. No commas
• price: The price of the item in major units. The cents must be in 00.
• quantity: The number of items bought. Integer.
• totalcost: The price multiplied by the quantity, in major units. The cents must be in 00.
Example:
[{\"name\":\"table\",\"price\":\"1000.00\",\"quantity\":2,\"totalcost\":\"2000.00\"},{\"name\":\"Laptop\",\"price\":\"15000.00\",\"quantity\":2,\"totalcost\":\"30000.00\"}]
The total transaction amount is 32000.00 |
**当 tag 为klarna 时,还需另外增加下面参数**
| 参数 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ------------------------------------------------------------ |
| taxamount | String | 是 | The total tax amount of the order in the currency's minor units. This information is essential to provide detailed purchase information to the consumer (e.g., on the invoice). |
| paymentmethodcategory | String | 否 | The payment method category.
Options:
• DIRECT_DEBIT
• DIRECT_BANK_TRANSFER
• PAY_NOW
• PAY_LATER
• PAY_OVER_TIME|
| billingaddress | String | 是 | The billing address. It is passed as a JSON string.
Example:
{\"city\":\"Munich\",\"country\":\"DE\",\"email\":\"test.customer@mpay.int\",\"phone\":\"07792555555\",\"family_name\":\"Doe\",\"given_name\":\"John Doe\",\"postal_code\":\"EH12 3AB\",\"street_address\":\"Ocean Point\"}|
| orderitems | String | 是 | The list of items being purchased formatted as a JSON array.
Example:
[{\"name\":\"apple\",\"quantity\":1,\"tax_rate\":1000,\"total_amount\":100,\"total_discount_amount\":20,\"total_tax_amount\":9,\"unit_price\":120}]
Field description:
• name: String. Descriptive name of the order line item.
• quantity: Integer. Quantity of the order line item. Must be a non-negative number.
• tax_rate: Integer. Tax rate of the order line. Non-negative value. The percentage value is represented with two implicit decimals. I.e 1000 = 10%.
• total_amount: Integer. Total amount of the order line. Must be defined as non-negative minor units. Includes tax and discount. Eg: 2500=25 euros. Value = (quantity * unit_price) - total_discount_amount. (max value: 100000000)
• total_discount_amount: Integer. Non-negative minor units. Includes tax. Eg: 500=5 euros.
• total_tax_amount: Integer. Total tax amount of the order line. Must be within ±1 of total_amount - total_amount * 10000 / (10000 + tax_rate). Negative when type is discount.
• unit_price: Integer. Price for a single unit of the order line. Non-negative minor units. Includes tax, excludes discount. (max value: 100000000) |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 9. India_Netbanking渠道
#### 9.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| bank_code | String | 是 |[见列表](India_Netbanking_BankCode.md) |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: IN|
| document_id | String | 是 | Consumer's Indian PAN. Must be string with 10 alphanumeric letters. 5 letters, followed by 4 numbers, followed by 1 letter or number. Example: ABCDE1234F|
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 10. PAYPAL渠道
#### 10.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 11. Neosurf渠道
#### 11.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: DE|
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
```javascript
测试Pincode:2639777698
```
### 12. DNC渠道
#### 12.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
#### 12.2 后台支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| ---------- | ------ | ---- | ------------------ |
| tradeFrom | String | 是 | "API" |
| cardno | String | 是 | 卡号 (RSA 公钥加密) |
| ExpiryDate | String | 是 | 有效期,格式:MM/YY (RSA 公钥加密) |
| cvv2 | String | 是 | CVN (RSA 公钥加密) |
```javascript
测试卡:
卡号: 5204730000002555
有效期: 12/25
CVV2: 123
```
### 13. Ksher渠道
#### 13.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| -------------- | ------ | ---- | ------------------------------------------------------------ |
| tradeFrom | String | 是 | "H5" |
| sub_brand_code | String | 是 | "linepay": Rabbit LINE Pay Wallet.
"airpay": Shopeepay Wallet.
"promptpay":PromptPay QR code (Thailand standard bank transfer QR code).
"truemoney": TrueMoney Wallet.
选其中一个上送 |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 14. FPX渠道
#### 14.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: MY |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 15. India_UPI渠道
#### 15.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| ----------------------- | --------- | ---- | ------------------------------------------------------------ |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer |
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 | Country code in ISO 3166. Example: IN |
| document_id | String | 是 | Consumer's Indian PAN. Must be string with 10 alphanumeric letters. 5 letters, followed by 4 numbers, followed by 1 letter or number. Example: ABCDE1234F |
| virtual_payment_address | String | 是 | Virtual Payment Address (VPA) of the customer, format: someone@bank |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| ------ | ------ | ---- | --------- |
| payUrl | String | 否 | 收银台URL |
### 16. Boleto渠道
#### 16.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| consumer_reference | String | 是 | Consumer reference is a unique consumer identifier|
| document_id | String | 是 | Document ID of the consumer. Consumer's Brazilian Identification Number(CPF or CNPJ). Must be string between 11 and 14 digits and to have full cpf validation.|
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: BR |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 17. Baloto渠道
#### 17.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| consumer_reference | String | 是 | Consumer reference is a unique consumer identifier|
| national_id | String | 是 | National ID of the consumer. Consumer's Colombian Identification Number(CC). Must be string between 6 to 10 digits.|
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: CO |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 18. PIX渠道
#### 18.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: BR |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 19. PSE渠道
#### 19.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| consumer_reference | String | 是 | Consumer reference is a unique consumer identifier|
| national_id | String | 是 | National ID of the consumer. Consumer's Colombian Identification Number(CC). Must be string between 6 to 10 digits.|
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: CO |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 20. Webpay渠道
#### 20.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| consumer_reference | String | 是 | Consumer reference is a unique consumer identifier|
| national_id | String | 是 | National ID of the consumer. Consumer's Chilean Identification Number(CI/RUT). Must be string between 8 to 9 digits.|
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: CL |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 21. OXXO渠道
#### 21.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| consumer_reference | String | 是 | Consumer reference is a unique consumer identifier|
| national_id | String | 是 | National ID of the consumer. Consumer's Mexican Identification Number(CURP). Must be string between 10 and 18 digits.|
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: MX |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 22. SPEI渠道
#### 22.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| document_id | String | 是 | Document ID of the consumer. Consumer's Mexican Identification Number(CURP). Must be string between 10 and 18 digits.|
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: MX |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 23. PagoEfectivo渠道
#### 23.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| document_id | String | 是 | Document ID of the consumer. Consumer's Peruvian Identification Number(DNI). Must be string between 8 and 9 digits.|
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: PE |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 24. Interbank渠道
#### 24.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| document_id | String | 是 | Document ID of the consumer. Consumer's Peruvian Identification Number(DNI). Must be string between 8 and 9 digits.|
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: PE |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 25 PayNow渠道
#### 25.1 二维码无跳转模式
该模式返回生成二维码的字符串,商户需要自己生成二维码。
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | -------- |
| tradeFrom | String | 是 | "QRCODE" |
| email | String | 是 | Customer email |
| payer_name | String | 是 | Customer name |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| code_url | String | 否 | 二维码字符串 |
### 26. P24渠道
#### 26.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: PL |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 27. Paysafecard渠道
#### 27.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| email | String | 是 | Must contain valid e-mail of customer|
| phone | String | 是 | Must contain valid phone number of customer |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: DE |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |
### 28. IDEAL渠道
#### 28.1 H5支付
**请求参数**
| 参数 | 类型 | 必填 | 描述 |
| --------- | ------ | ---- | ---- |
| tradeFrom | String | 是 | "H5" |
| firstname | String | 是 | Customer first name |
| lastname | String | 是 | Customer last name |
| address | String | 是 | address |
| zip_code | String | 是 | ZIP code |
| city | String | 是 | City |
| country | String(2) | 是 |Country code in ISO 3166. Example: NL |
**响应参数parameter详情**
| 参数 | 类型 | 必填 | 描述 |
| -------- | ------ | ---- | ------------------------------- |
| payUrl | String | 否 | 收银台URL |