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外卡)
  • 5.3 后台支付(适用于外卡3DS)
• 6. RevPay渠道
  • 6.1 H5支付
• 7. AliPayPlus渠道
  • 7.1 H5支付
  • 7.2 WebSite支付
  • 7.3 二维码无跳转模式
  • 7.4 APP支付
  • 7.5 小程序支付
• 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. Ksher渠道
  • 13.1 H5支付
• 14. FPX渠道
  • 14.1 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对接文档调用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

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

响应参数parameter详情

参数	类型	必填	描述
payUrl	String	否	3DS URL

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. 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对接文档调用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.
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   • 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	是	见列表
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. 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"
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
state	String(2)	否	State code in ISO 3166-2, required for USA and Canada

响应参数parameter详情

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