common/payExclusive_CH.md

渠道专属参数

目录：

• 1. WX渠道
  • 1.1 二维码无跳转模式
  • 1.2 二维码跳转模式
  • 1.3 公众号支付
  • 1.4 小程序支付
  • 1.5 APP支付
• 2. AP渠道
  • 2.1 WebSite支付
  • 2.2 H5支付
  • 2.3 APP支付
  • 2.4 二维码无跳转模式
  • 2.5 小程序支付
• 3. UP渠道
  • 3.1 H5支付
  • 3.2 APP支付
  • 3.3 二维码无跳转模式
  • 3.4 Express Pay
• 4. Apple Pay渠道
  • 4.1 APP支付
• 5. FC渠道
  • 5.1 H5支付
    • 5.1.1 CIL外卡
    • 5.1.2 SN外卡
    • 5.1.3 TL外卡
    • 5.1.4 ICBC外卡
    • 5.1.5 RDP外卡
    • 5.1.6 VT外卡
  • 5.2 后台支付(适用于SN和TL外卡)
• 6. RevPay渠道
  • 6.1 H5支付
• 7. AliPayLocal渠道
  • 7.1 H5支付
• 8. PO渠道
  • 8.1 H5支付
• 9. India_Netbanking渠道
  • 9.1 H5支付
• 10. PAYPAL渠道
  • 10.1 H5支付
• 11. Neosurf渠道
  • 11.1 H5支付
• 12. DNC渠道
  • 12.1 H5支付
  • 12.2 后台支付
• 13. AliPayPlus渠道
  • 13.1 H5支付
  • 13.2 WebSite支付
  • 13.3 二维码无跳转模式
  • 13.4 APP支付

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对接文档调用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对接文档调用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对接文档调用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

测试卡：

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对接文档调用SDK进行支付。

5. FC渠道

5.1 H5支付

5.1.1 CIL外卡

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"H5"

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	否	物流城市
logisticsStreet	String	否	物流地址
logisticsPostalCode	String	否	物流邮编
logisticsEmail	String	否	物流邮箱

SN测试卡：

卡号: 5309289710447190
有效期: 0825
CVV2: 900

5.1.3 TL外卡

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"H5"
email	String	否	持卡人电子邮件地址
logisticsCountry	String	是	物流国家/地区，2位国家码，如：US
logisticsState	String	是	物流州/省/邦，2位编码，如：CA
logisticsCity	String	是	物流城市
logisticsStreet	String	是	物流地址
logisticsPostalCode	String	是	物流邮编
logisticsPhone	String	是	物流电话

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
卡号2：4377651201379895
卡号3：5440163901773005
卡号4：5305063800002981
卡号5：5305066800004683
卡号6：5305063800001223

5.1.5 RDP外卡

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"H5"

RDP测试卡：

卡号: 4111111111111111
有效期: 122027
CVV2: 123

卡号: 5200000900007102
有效期: 122027
CVV2: 123

5.1.6 VT外卡

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"H5"

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	否	物流城市
logisticsStreet	String	否	物流地址
logisticsPostalCode	String	否	物流邮编
logisticsEmail	String	否	物流邮箱
logisticsPhone	String	否	物流电话
pcToken2	String	否	设备指纹
forterTokenCookie	String	否	客户端埋点
userIP	String	否	用户IP

6. RevPay渠道

6.1 H5支付

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"H5"
Payment_ID	String	是	Axiata Boost: 11 Grab Pay: 17 Touch ’n Go: 28 Maybank QR: 12

响应参数parameter详情

参数	类型	必填	描述
payUrl	String	否	收银台URL

7. AliPayLocal渠道

7.1 H5支付

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"H5"
sub_brand_code	String	是	"gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng" 选其中一个上送

响应参数parameter详情

参数	类型	必填	描述
payUrl	String	否	收银台URL

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
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.
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 purchased items. Make sure you follow the following format for the orderitems parameter: "<item_description>,<unit_price_with_two_decimal_places>,<quantity>,<total_cost_per_item_with_two_decimal_places>". Use commas to separate each field and semicolon to separate each item. The only allowed characters in the item description are alphanumeric, blank space, hyphen, and dot. Ensure that the total cost of all items equals the transaction amount. If the format or the total cost of the items are not correct, the order details do not show on payment page. Example: "table,1000.00,2,2000.00;Laptop 2.0,15000.00,2,30000.00" In the example above, there are two items in the basket: 1. Item 1   • Description: table   • Unit price: 1000.00   • Quantity: 2   • Total cost: 2000.00 2. Item 2   • Description: Laptop 2.0   • Unit price: 15000.00   • Quantity: 2   • Total cost: 30000.00 The total transaction amount is 32000.00

响应参数parameter详情

参数	类型	必填	描述
payUrl	String	否	收银台URL

9. India_Netbanking渠道

9.1 H5支付

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"H5"
bank_code	String	是	见列表
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

测试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 公钥加密)

测试卡：

卡号: 5204730000002555
有效期: 12/25
CVV2: 123

13. AliPayPlus渠道

13.1 H5支付

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"H5"
OsType	String	是	"IOS", "ANDROID" 选其中一个上送
sub_brand_code	String	是	"gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng" 选其中一个上送

响应参数parameter详情

参数	类型	必填	描述
payUrl	String	否	收银台URL

13.2 WebSite支付

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"WEB"
sub_brand_code	String	是	"gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng" 选其中一个上送

响应参数parameter详情

参数	类型	必填	描述
payUrl	String	否	收银台URL

13.3 二维码无跳转模式

该模式返回生成二维码的字符串，商户需要自己生成二维码。

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"QRCODE"
sub_brand_code	String	是	"gcash", "kakaopay", "alipay_hk", "tng" 选其中一个上送

响应参数parameter详情

参数	类型	必填	描述
code_url	String	否	二维码字符串

13.4 APP支付

请求参数

参数	类型	必填	描述
tradeFrom	String	是	"APP"
OsType	String	是	"IOS", "ANDROID" 选其中一个上送
sub_brand_code	String	是	"gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng" 选其中一个上送

响应参数parameter详情

参数	类型	必填	描述
tn	String	否	交易流水号，作为调起 sdk 支付的参数

获取到tn后，根据APP对接文档调用SDK进行支付。