payExclusive_CH.md 47 KB

渠道专属参数

目录:

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

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
national_id String National ID of the consumer.
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

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.
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

18. PIX渠道

18.1 H5支付

请求参数

参数 类型 必填 描述
tradeFrom String "H5"
consumer_reference String Consumer reference is a unique consumer identifier
document_id String document_id of the consumer.
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