payExclusive_EN.md 39 KB

Channel exclusive fields

Table of Contents:

1. WX

1.1 QR code no jump mode

This mode returns the QR code string, and merchants need to generate the QR code themselves.

Request parameters

Parameter Type Required Description
tradeFrom String Yes "QRCODE"

Response parameter "parameter" details

Parameter Type Required Description
code_url String No QR code string

1.2 QR code jump mode

This mode will redirect to the QR code page generated by GoAllPay.

Request parameters

Parameter Type Required Description
tradeFrom String Yes "QUICK"

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

1.3 WeChat Official Accounts payment

Request parameters

Parameter Type Required Description
tradeFrom String Yes "JSAPI"

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Payment URL

1.4 WeChat Mini Programs payment

Request parameters

Parameter Type Required Description
tradeFrom String Yes "APPLET"
openid String Yes Wechat openid

Response parameter "parameter" details

Parameter Type Required Description
sdk_params Object No Required parameter for Mini Program payment.

Parameter sdk_params is used to call up the WeChat Mini Programs payment. Please refer to the WeChat Mini Programs integration specification.

1.5 APP mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "APP"

Response parameter "parameter" details

Parameter Type Required Description
tn String No Transaction serial number. Required parameter for Wechat app payment.

After getting tn, call the SDK to pay according to APP document.

2. AP

2.1 WebSite mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "WEB"

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

2.2 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "JSAPI"

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Payment URL

2.3 APP mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "APP"

Response message:

Parameter Type Required Description
tn String No Transaction serial number. Required parameter for Alipay app payment.

After getting tn, call the SDK to pay according to APP document.

2.4 QR code no jump mode

This mode returns the QR code string, and merchants need to generate the QR code themselves.

Request parameters

Parameter Type Required Description
tradeFrom String Yes "QRCODE"

Response parameter "parameter" details

Parameter Type Required Description
code_url String No QR code string

2.5 Alipay Mini Programs payment

Request parameters

Parameter Type Required Description
tradeFrom String Yes "APPLET"

Response parameter "parameter" details

Parameter Type Required Description
sdk_params String No Required parameter for Mini Program payment.

Parameter sdk_params is used to call up the Alipay Mini Programs payment. Please refer to the Alipay Mini Programs integration specification.

3. UP

3.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

3.2 APP mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "APP"

Response message:

Parameter Type Required Description
tn String No Transaction serial number. Required parameter for app payment.

After getting tn, call the SDK to pay according to APP document.

3.3 QR code no jump mode

This mode returns the QR code string, and merchants need to generate the QR code themselves.

Request parameters

Parameter Type Required Description
tradeFrom String Yes "QRCODE"

Response parameter "parameter" details

Parameter Type Required Description
code_url String No QR code string

3.4 Express Pay

Request parameters

Parameter Type Required Description
tradeFrom String Yes "PAN-PRESENT"
cardno String Yes UnionPay card number
cvv String Yes cvv2
expired String Yes Expiry Date. Format: YYMM
Test cards:

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 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "APP"

Response parameter "parameter" details

Parameter Type Required Description
tn String No Transaction serial number. Required parameter for Apple Pay.

After getting tn, call the SDK to pay according to APP document.

5. FC

5.1 H5 mode

5.1.1 CIL international card

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
CIL test card

Card Number: 4761340000000019
Expiry Date: 1217
CVV2: 830

Card Number: 5204730000002555
Expiry Date: 1225
CVV2: 123
5.1.2 SN international card

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
billCountry String No Billing country/region, 2-digit country code, such as: US
billState String No Billing state/province/state, 2-digit code, such as: CA
billCity String No Billing city
billStreet String No Billing address
billEmail String No Billing email
billPostalCode String No Billing zip code
logisticsCountry String No Logistics country/region, 2-digit country code, such as: US
logisticsState String No Logistics state/province/state, 2-digit code, such as: CA
logisticsCity String No Logistics city
logisticsStreet String No Logistics address
logisticsPostalCode String No Logistics zip code
logisticsEmail String No Logistics email
SN test card

Card Number: 5309289710447190
Expiry Date: 0825
CVV2: 900
5.1.3 TL international card

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
email String No Cardholder email
logisticsCountry String Yes Logistics country/region, 2-digit country code, such as: US
logisticsState String Yes Logistics state/province/state, 2-digit code, such as: CA
logisticsCity String Yes Logistics city
logisticsStreet String Yes Logistics address
logisticsPostalCode String Yes Logistics zip code
logisticsPhone String Yes Logistics phone number
TL test card

Card Number: 4012001037141112
Expiry Date: 1227
CVV2: 212

Card Number: 5204740000001002
Expiry Date: 1227
CVV2: 212
5.1.4 ICBC international card

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
ieu String Yes Language identification.
Portuguese: pt-BR
English: en-US
Chinese (simplified) : zh-CN
Chinese (traditional) : zh-TW
Please post these parameters strictly according to the document.

ICBC test card

Click the card number to get the SMS verification code.
Card 1: 4574108900117879
Card 2: 4377651201379895
Card 3: 5440163901773005
Card 4: 5305063800002981
Card 5: 5305066800004683
Card 6: 5305063800001223

5.1.5 RDP international card

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
RDP test card

Card Number: 4111111111111111
Expiry Date: 122027
CVV2: 123

Card Number: 5200000900007102
Expiry Date: 122027
CVV2: 123
5.1.6 VT international card

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
VT test card

Card Number: 4111111111111111
Expiry Date: 1227
CVV2: 123

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

5.2 Background mode (Applicable to SN and TL international card)

Request parameters

Parameter Type Required Description
tradeFrom String Yes "API"
cardNo String Yes Card Number
expDate String Yes Expiry Date. Format: MMYY
cvnCode String Yes CVN
lastName String Yes Last Name
firstName String Yes First Name
billCountry String No Billing country/region, 2-digit country code, such as: US
billState String No Billing state/province/state, 2-digit code, such as: CA
billCity String No Billing city
billStreet String No Billing address
billEmail String No Billing email
billPostalCode String No Billing zip code
billPhone String No Billing phone
logisticsCountry String No Logistics country/region, 2-digit country code, such as: US
logisticsState String No Logistics state/province/state, 2-digit code, such as: CA
logisticsCity String No Logistics city
logisticsStreet String No Logistics address
logisticsPostalCode String No Logistics zip code
logisticsEmail String No Logistics email
logisticsPhone String No Logistics phone
pcToken2 String No Device fingerprint
forterTokenCookie String No Client buried point
userIP String No User IP

5.3 Background mode (Applicable to International card 3DS)

Request parameters

Parameter Type Required Description
tradeFrom String Yes "API-3DS"
cardNo String Yes Card Number
expDate String Yes Expiry Date. Format: MMYY
cvnCode String Yes CVN
lastName String Yes Last Name
firstName String Yes First Name
billCountry String No Billing country/region, 2-digit country code, such as: US
billState String No Billing state/province/state, 2-digit code, such as: CA
billCity String No Billing city
billStreet String No Billing address
billEmail String Condition Billing email. Required for RDP
billPostalCode String No Billing zip code
billPhone String No Billing phone
logisticsCountry String No Logistics country/region, 2-digit country code, such as: US
logisticsState String No Logistics state/province/state, 2-digit code, such as: CA
logisticsCity String No Logistics city
logisticsStreet String No Logistics address
logisticsPostalCode String No Logistics zip code
logisticsEmail String No Logistics email
logisticsPhone String No Logistics phone
pcToken2 String No Device fingerprint
forterTokenCookie String No Client buried point
userIP String No User IP

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No 3DS URL

6. RevPay

6.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
Payment_ID String Yes Axiata Boost: 11
Grab Pay: 17
Touch ’n Go: 28
Maybank QR: 12

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

7. AliPayPlus

7.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
sub_brand_code String Yes "gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng"
Choose one of them.

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

7.2 WebSite mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "WEB"
sub_brand_code String Yes "gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng"
Choose one of them.

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

7.3 QR code no jump mode

This mode returns the QR code string, and merchants need to generate the QR code themselves.

Request parameters

Parameter Type Required Description
tradeFrom String Yes "QRCODE"
sub_brand_code String Yes "gcash", "kakaopay", "alipay_hk", "tng"
Choose one of them.

Response parameter "parameter" details

Parameter Type Required Description
code_url String No QR code string

7.4 APP mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "APP"
sub_brand_code String Yes "gcash", "dana", "kakaopay", "alipay_hk", "truemoney", "tng"
Choose one of them.

Response parameter "parameter" details

Parameter Type Required Description
tn String No Transaction serial number. Required parameter for app payment.

After getting tn, call the SDK to pay according to APP document.

8. PO

8.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
tag String Yes Value: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 Yes 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 Yes The account holder - minimum of 3 characters, up to 100 characters.

When tag is paysafecard, you should add the following parameters:

Parameter Type Required Description
consumerref String No Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20}

When tag is in aura, baloto, bancodobrasil, boleto, hipercard, itau, webpay, you should add the following parameters:

Parameter Type Required Description
consumerref String Yes Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20}
nationalid String Yes Consumer’s national id (up to 30 characters)
email String Yes RFC compliant email address of the account holder
address String Yes Consumer's address
zipcode String Yes Consumer's zip/postal code
dob String No Date of birth, format YYYYMMDD

When tag is in dragonpay, enets, you should add the following parameters:

Parameter Type Required Description
email String Yes RFC compliant email address of the account holder
phone String Yes Valid international phone number of the account holder

When tag is in giropay, directpay, you should add the following parameters:

Parameter Type Required Description
bic String No Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank

When tag is in payu, p24, safetypay, you should add the following parameters:

Parameter Type Required Description
email String Yes RFC compliant email address of the account holder

When tag is qiwi, you should add the following parameters:

Parameter Type Required Description
mobilephone String Yes 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 Yes Unique site identifier, forwarded to qiwi. Required for clients serving multiple points of sale.

When tag is skrill, you should add the following parameters:

Parameter Type Required Description
email String No RFC compliant email address of the account holder
address String No Consumer's address
zipcode String No Consumer's zip/postal code
city String No Consumer’s city

When tag is sepaddmodela, you should add the following parameters:

Parameter Type Required Description
email String Yes RFC compliant email address of the account holder
iban String Yes Valid IBAN

When tag is bcmc, you should add the following parameters:

Parameter Type Required Description
BEPURL String No Trigger URL for mobile payment options in the form BEP://1BC.GIROGATE.DE/BCMC/123456789$ICAE3BUIH5P9U53Y5HKA9CRT (contrived example).

When tag is in santander, pagofacil, rapipago, you should add the following parameters:

Parameter Type Required Description
nationalid String Yes Consumer’s national id (up to 30 characters)
consumerref String No Unique reference identifying the consumer, has to satisfy the following regular expression: [A-Za-z0-9.%,&/+*$-]{1,20}
email String Yes RFC compliant email address of the account holder

When tag is in konbini, payeasy, you should add the following parameters:

Parameter Type Required Description
phone String Yes Consumer phone number without hyphens, country code or other characters (single-byte alphanumeric; must be between 10-11 digits)
email String Yes RFC compliant email address of the account holder
iteminfo String Yes Information about the item(s) being purchased, displayed on the payment page (up to 22 characters)

When tag is in doku, ovo, you should add the following parameters:

Parameter Type Required Description
email String Yes RFC compliant email address of the account holder
orderitems String Yes 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

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

9. India_Netbanking

9.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
bank_code String Yes bank list
email String Yes Must contain valid e-mail of customer
phone String Yes Must contain valid phone number of customer
firstname String Yes Customer first name
lastname String Yes Customer last name
address String Yes address
zip_code String Yes ZIP code
city String Yes City
country String(2) Yes Country code in ISO 3166. Example: IN
document_id String Yes 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

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

10. PAYPAL

10.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

11. Neosurf

11.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
email String Yes Must contain valid e-mail of customer
phone String Yes Must contain valid phone number of customer
firstname String Yes Customer first name
lastname String Yes Customer last name
address String Yes address
zip_code String Yes ZIP code
city String Yes City
country String(2) Yes Country code in ISO 3166. Example: DE

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL
Test Pincode: 2639777698

12. DNC

12.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL

12.2 Background mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "API"
cardno String Yes Card number. Encrypted with RSA public key
ExpiryDate String Yes Expiry date. Format: MM/YY. Encrypted with RSA public key
cvv2 String Yes CVV2. Encrypted with RSA public key
Test card

Card Number: 5204730000002555
Expiry Date: 1225
CVV2: 123

13. Ksher

13.1 H5 mode

Request parameters

Parameter Type Required Description
tradeFrom String Yes "H5"
sub_brand_code String Yes "linepay": Rabbit LINE Pay Wallet.
"airpay": Shopeepay Wallet.
"promptpay":PromptPay QR code (Thailand standard bank transfer QR code).
"truemoney": TrueMoney Wallet.
Choose one of them.

Response parameter "parameter" details

Parameter Type Required Description
payUrl String No Cashier URL