common/payExclusive_CH.md

渠道专属配置

1 WX渠道

1.1 二维码无跳转模式

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

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"QRCODE"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
code_url	String	O	二维码字符串。应答码为00返回该参数

1.2 二维码跳转模式

该模式会为商户跳转到GoAllPay生成好的二维码页面，无需商户自己生成。

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"QUICK"

1.3 公众号支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"JSAPI"

1.4 小程序支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"APPLET"
openid	String	M	微信openid

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
sdk_params	String	O	小程序支付所需参数（JSON字符串）。应答码为00返回该参数

将上述返回数据放入微信小程序支付接口，即可调起支付，具体方法，参考微信官方小程序API。

1.5 APP支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"APP"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

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

2 AP渠道

2.1 WebSite支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"WEB"

2.2 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"JSAPI"

2.3 APP支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"APP"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

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

2.4 二维码无跳转模式

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

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"QRCODE"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
code_url	String	O	二维码字符串。应答码为00返回该参数

2.5 小程序支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"APPLET"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
sdk_params	String	O	小程序支付所需参数。应答码为00返回该参数

将上述返回数据放入支付宝小程序支付接口，即可调起支付，具体方法，参考支付宝官方小程序API。

3 UP渠道

3.1 H5支付,自适应PC和移动端

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"H5"

3.2 APP支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"APP"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

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

3.3 二维码无跳转模式

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

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"QRCODE"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
code_url	String	O	二维码字符串。应答码为00返回该参数

3.4 Express Pay

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"PAN-PRESENT"
cardno	String	M	卡号
cvv	String	M	cvv2
expired	String	M	有效期 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	M	"APP"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

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

5 CA渠道

5.1 APP支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"APP"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

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

6 MIPAY渠道

6.1 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"H5"
firstname	String	M	This is name of the customer who is doing the transaction.
email	String	M	this is email id of the customer who is doing transaction
phone	String	M	Phone number of the customer
customerId	String	O	Customer ID, when client register on merchant, merchant distribute it to client.

测试环境配置：

修改测试机器hosts,添加如下两条信息
114.80.87.249 account.preview.n.xiaomi.net
114.80.87.249 api.account.preview.n.xiaomi.net

测试卡：

卡号：5123456789012346
有效期：0520
cvv：123

7 EB渠道

7.1 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"H5"
firstname	String	M	This is name of the customer who is doing the transaction.
email	String	M	this is email id of the customer who is doing transaction
phone	String	M	Phone number of the customer

8 PF渠道

8.1 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"H5"
showShipAddr	String	M	"1"：显示账单填写表单 "0"：不显示账单填写表单
shipAddr	String	O	showShipAddr为1时不用传该参数，为0时需上传。 Base64_encode(json_encode(str) ) 举例{"first_name":"","last_name":"","street":"address_line1","house_number":"address_line2","address_city":"new york","address_state":"new york","country_id":"us","address_zip":"10022","phone_num":"13512345678","email_address":"dd@126.com"}
email	String	M	用户email
shipping	String	M	收件地址：Base64_encode(json_encode(str))举例 {"first_name":"dsgerg","last_name":"eererger","phone":"13460259928","line1":"address_line1","line2":"address_line2","city":"new york","state":"new york","country_code":"us","postal_code":"10022"}

测试卡：

Card Number: 4242424242424242
Expriation Date: 1122
CVC: 111

9 APHK渠道

9.1 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"JSAPI"

9.2 二维码无跳转模式

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

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"QRCODE"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
code_url	String	O	二维码字符串。应答码为00返回该参数

9.3 APP支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"APP"

响应参数：

参数	类型	属性	描述
RespCode	String	M	应答码 00-成功
RespMsg	String	M	应答消息
tn	String	O	交易流水号，RespCode为“00”时返回，作为调起 sdk 支付的参数

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

10 FC渠道

10.1 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"H5"

测试卡：

卡号: 4761340000000019
有效期: 1217
CVV2: 830

卡号: 5204730000002555
有效期: 1225
CVV2: 123

苏宁渠道消费接口还需增加以下专属参数：

账单信息

参数	类型	属性	描述
billCountry	String	O	账单国家/地区，2位国家码，如：US
billState	String	O	账单州/省/邦，2位编码，如：CA
billCity	String	O	账单城市
billStreet	String	O	账单地址
billEmail	String	O	账单邮箱
billPostalCode	String	O	账单邮编

物流信息

参数	类型	属性	描述
logisticsCountry	String	O	物流国家/地区，2位国家码，如：US
logisticsState	String	O	物流州/省/邦，2位编码，如：CA
logisticsCity	String	O	物流城市
logisticsStreet	String	O	物流地址
logisticsPostalCode	String	O	物流邮编
logisticsEmail	String	O	物流邮箱

苏宁测试卡：

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

10.2 后台支付(仅适用于苏宁外卡)

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"API"

账户信息

参数	类型	属性	描述
cardNo	String	M	卡号
expDate	String	M	有效期，格式：MMYY
cvnCode	String	M	CVN
lastName	String	M	Last Name
firstName	String	M	First Name

账单信息

参数	类型	属性	描述
billCountry	String	O	账单国家/地区，2位国家码，如：US
billState	String	O	账单州/省/邦，2位编码，如：CA
billCity	String	O	账单城市
billStreet	String	O	账单地址
billEmail	String	O	账单邮箱
billPostalCode	String	O	账单邮编

物流信息

参数	类型	属性	描述
logisticsCountry	String	O	物流国家/地区，2位国家码，如：US
logisticsState	String	O	物流州/省/邦，2位编码，如：CA
logisticsCity	String	O	物流城市
logisticsStreet	String	O	物流地址
logisticsPostalCode	String	O	物流邮编
logisticsEmail	String	O	物流邮箱

11 RevPay渠道

11.1 H5支付

消费接口专属参数

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

12 AliPayLocal渠道

12.1 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"H5"
sub_brand_code	String	M	"gcash", "dana", "kakaopay", "alipay_hk" 选其中一个上送

13 PO渠道

13.1 H5支付

消费接口专属参数

参数	类型	属性	描述
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	取值如下：directpay, boleto, webpay, trustpay, skrill, singpost, 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

13.1.1 当 tag 为 paysafecard 时，还需另外增加下面参数

参数	类型	属性	描述
consumerref	String	M	Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20}

13.1.2 当 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

13.1.3 当 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

13.1.4 当 tag 为 giropay, directpay 时，还需另外增加下面参数

参数	类型	属性	描述
bic	String	O	Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank

13.1.5 当 tag 为 payu, p24, safetypay 时，还需另外增加下面参数

参数	类型	属性	描述
email	String	M	RFC compliant email address of the account holder

13.1.6 当 tag 为 qiwi 时，还需另外增加下面参数

参数	类型	属性	描述
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.

13.1.7 当 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

13.1.8 当 tag 为 sepaddmodela 时，还需另外增加下面参数

参数	类型	属性	描述
email	String	M	RFC compliant email address of the account holder
iban	String	M	Valid IBAN

13.1.9 当 tag 为 bcmc 时，还需另外增加下面参数

参数	类型	属性	描述
BEPURL	String	O	Trigger URL for mobile payment options in the form BEP://1BC.GIROGATE.DE/BCMC/123456789$ICAE3BUIH5P9U53Y5HKA9CRT (contrived example).

13.1.10 当 tag 为 santander, pagofacil, rapipago 时，还需另外增加下面参数

参数	类型	属性	描述
nationalid	String	M	Consumer’s national id (up to 30 characters)
consumerref	String	O	Unique reference identifying the consumer, has to satisfy the following regular expression: [A-Za-z0-9.%,&/+*$-]{1,20}
email	String	M	RFC compliant email address of the account holder

13.1.11 当 tag 为 konbini, payeasy 时，还需另外增加下面参数

参数	类型	属性	描述
phone	String	M	Consumer phone number without hyphens, country code or other characters (single-byte alphanumeric; must be between 10-11 digits)
email	String	M	RFC compliant email address of the account holder
iteminfo	String	M	Information about the item(s) being purchased, displayed on the payment page (up to 22 characters)

13.1.12 当 tag 为 doku, ovo 时，还需另外增加下面参数

参数	类型	属性	描述
email	String	M	RFC compliant email address of the account holder
orderitems	String	M	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

14 India_Netbanking渠道

14.1 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"H5"
bank_code	String	M	见列表
email	String	M	Must contain valid e-mail of customer
phone	String	M	Must contain valid phone number of customer
firstname	String	M	Customer first name
lastname	String	M	Customer last name
address	String	M	address
zip_code	String	M	ZIP code
city	String	M	City
country	String	M	Country code in ISO 3166
state	String	M	State code in ISO 3166-2, required for USA and Canada
document_id	String	M	Document ID of the consumer.

15 PAYPAL渠道

15.1 H5支付

消费接口专属参数

参数	类型	属性	描述
tradeFrom	String	M	"H5"