# 5.渠道专属配置 ## 5.1 EB渠道(跳转） 序号 |名称 |长度|类型|参数名称|备注 -----|-----|----|----|------|------ 1| 姓名 |32 |文本|trxn_firstname |This is name of the customer who is doing the transaction. 2| 邮箱 |40 |文本|trxn_email_id |this is email id of the customer who is doing transaction. 3|电话 |20 |文本|trxn_phone|Phone number of the customer. ## 5.2 UP渠道(跳转） 序号 |名称 |长度|类型|参数名称|备注 -----|-----|----|----|------|------ 1| 银联卡号 |19 | 文本|uCardNumber |境外银联通道，适用于银联优计划。可以不上送，若需要提前填入银行卡号，则上送此字段。 ## 5.3 WX渠道(含跳转和参数返回） 序号 |名称 |长度|类型|参数名称|备注 -----|-----|----|----|------|------ 1| 交易场景代码|16 | 文本|code |1.“NATIVE“：为参数返回方式，返回微信收款URL值, 要求商户将其转换为 QR 码，自己生成支付前端界 面，提示用户扫码付款; 2.“QUICK”：为跳转方式，打开 AllPay 提供的前端页面，页面包含微信 QR 码 ## 5.4 PPRO相关渠道(跳转） ## 5.4.1 PPRO_AC Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} Note: AstroPay Card is available for currency USD and country codes BO, BR, CL, CN, CO, CR, MX, PE, UY, VE. ​ ## 5.4.2 PPRO_AD Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} Note: AstroPay Direct is available for currency USD and country codes AR, BR, CL, CN, CO, MX, PE, UY, CN ## 5.4.3 PPRO_AR Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} nationalid |M |文本 |Consumer’s national id (up to 30 characters) email |M |文本 |RFC compliant email address of the account holder address |M |文本 |Consumer's address zipcode |M |文本 |Consumer's zip/postal code dob |O |文本 |Date of birth, format YYYYMMDD Note: Aura (Brazil) is available for currency USD and country code BR. ## 5.4.4 PPRO_BA Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} nationalid |M |文本 |Consumer’s national id (up to 30 characters) email |M |文本 |RFC compliant email address of the account holder address |M |文本 |Consumer's address zipcode |M |文本 |Consumer's zip/postal code dob |O |文本 |Date of birth, format YYYYMMDD Note: Baloto Cash (Colombia) is available for currency USD and country code CO. ## 5.4.5 PPRO_BB Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} nationalid |M |文本 |Consumer’s national id (up to 30 characters) email |M |文本 |RFC compliant email address of the account holder address |M |文本 |Consumer's address zipcode |M |文本 |Consumer's zip/postal code dob |O |文本 |Date of birth, format YYYYMMDD Note: Banco do Brasil (Brazil) is available for currency USD and country code BR. ## 5.4.6 PPRO_BO Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} nationalid |M |文本 |Consumer’s national id (up to 30 characters) email |M |文本 |RFC compliant email address of the account holder address |M |文本 |Consumer's address zipcode |M |文本 |Consumer's zip/postal code dob |O |文本 |Date of birth, format YYYYMMDD Note: Boleto Bancario is available for currency USD and country code BR. ## 5.4.7 PPRO_DR Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. email |M |文本 |RFC compliant email address of the account holder phone |M |文本 |Valid international phone number of the account holder Note: Dragonpay is only available for currency PHP and country code PH. ## 5.4.8 PPRO_EN Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. email |M |文本 |RFC compliant email address of the account holder phone |M |文本 |Valid international phone number of the account holder Note: eNETS is only available for currency SGD and country code SG. ## 5.4.9 PPRO_EP Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. Note: eps only works for the countrycode “AT” and currency “EUR”. ## 5.4.10 PPRO_GP Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. bic |O |文本 |Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank the countrycode “DE” and currency “EUR”. ## 5.4.11 PPRO_HC Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} nationalid |M |文本 |Consumer’s national id (up to 30 characters) email |M |文本 |RFC compliant email address of the account holder address |M |文本 |Consumer's address zipcode |M |文本 |Consumer's zip/postal code dob |O |文本 |Date of birth, format YYYYMMDD Note: Hipercard (Brazil) is available for currency USD and country code BR. ## 5.4.12 PPRO_ID Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. Note: iDEAL only works for the countrycode “NL” and currency “EUR”. Here is the list of currently available issuers and their associated BIC： ![image](/b2c/bic_list.jpg) ## 5.4.13 PPRO_IT Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} nationalid |M |文本 |Consumer’s national id (up to 30 characters) email |M |文本 |RFC compliant email address of the account holder address |M |文本 |Consumer's address zipcode |M |文本 |Consumer's zip/postal code dob |O |文本 |Date of birth, format YYYYMMDD Note: Itaú (Brazil) is available for currency USD and country code BR. ## 5.4.14 PPRO_MB Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. Note: MyBank only works for the country code IT and currency EUR. ## 5.4.15 PPRO_PC Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} ## 5.4.16 PPRO_PU Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. email |M |文本 |RFC compliant email address of the account holder Note: PayU works only for country code/currency combinations CZ/CZK and PL/PLN. ## 5.4.17 PPRO_PL Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. Note: POLi only works for the countrycode/currency combinations “NZ”/”NZD” and “AU/AUD”. ## 5.4.18 PPRO_P24 Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. email |M |文本 |RFC compliant email address of the account holder Note: Przelewy24 only works for the countrycode “PL” and currencies “PLN” and “EUR”. ## 5.4.19 PPRO_QW Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. mobilephone|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|M/O |文本 |Unique site identifier, forwarded to qiwi. Required for clients serving multiple points of sale. Note: QIWI Payout only works for the countrycodes “RU”, “KZ” and UA, and - depending on your contract - currency 
“RUB” , “EUR” ,”KZT” and “USD”. 
 ## 5.4.20 PPRO_SP Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. email |M |文本 |RFC compliant email address of the account holder Note:SafetyPay only works for country codes “AT”, “BE”, “BR”, “CL”, “CR”, “DE”, “EC”, “ES”, “MX”, “NL”, “PE” and currencies “EUR”, “USD”. ## 5.4.21 PPRO_SD Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. Note: SEPA Direct Debit works for all SEPA countries and currency EUR. ## 5.4.22 PPRO_SG Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. email |M |文本 |RFC compliant email address of the account holder phone |M |文本 |Valid international phone number of the account holder Note: SingPost (Singapore) is only available for currency SGD and country code SG. ## 5.4.23 PPRO_SK Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. email |O |文本 |RFC compliant email address of the account holder address |O |文本 |Consumer’s address (e.g. street) zipcode |O |文本 |Consumer’s postal code city |O |文本 |Consumer’s city ```xml The account holder name passed in the request has to be in the format , with lastname having a minimum length of two characters and the total string a minimum length of five. Multiple first names are ok, valid examples are “John Dorian”, “William Charles Dickinson”. If these conditions are not met, the system will not accept the request ``` ## 5.4.24 PPRO_SB Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. bic |O |文本 |Valid BIC (8 or 11 alphanumeric letters) of consumer’s bank OFORT Banking (also known as SOFORT überweisung, formally DirectPay24) is available in Austria, Belgium, Germany, Spain, Italy and Netherlands (country codes AT, BE, DE, ES, IT, NL). EUR is supported in all countries. ## 5.4.25 PPRO_TP Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. Note: TrustPat is only available for currency EUR and country code CZ, SK ## 5.4.26 PPRO_WP Field name |M/O |Type |Description -----|-----|----|---- countrycode|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|M |文本 |The account holder - minimum of 3 characters, up to 100 charac- ters. consumerref |M |文本 |Unique reference identifying the consumer, has to satisfy the regular expression [A-Za-z0-9.%,&/+*$-]{1,20} nationalid |M |文本 |Consumer’s national id (up to 30 characters) email |M |文本 |RFC compliant email address of the account holder address |M |文本 |Consumer's address zipcode |M |文本 |Consumer's zip/postal code dob |O |文本 |Date of birth, format YYYYMMDD Note: WebPay is available for currency USD and country code CL. ## 5.5 AP渠道 消费接口专属字段 - 请求报文 | Parameter | Type | Required | Description | Sample | | --------- | ---------- | -------- | ------------------------------------------------------------ | -------------------------------------- | | timeout | String(10) | O | The default is 12h. Please contact Alipay Technical Support if you need to use other values. Max value is 15d. This parameter controls the valid time from login to completion. | 5m 10m 15m 30m 1h 2h 3h 5h 10h 12h 1d. | ## 5.6 MIPAY渠道(跳转） | 序号 | 名称 | 长度 | 类型 | 参数名称 | 备注 | | ---- | ------ | ---- | ---- | ---------- | ------------------------------------------------------------ | | 1 | 姓名 | 32 | 文本 | firstname | This is name of the customer who is doing the transaction. | | 2 | 邮箱 | 40 | 文本 | email | this is email id of the customer who is doing transaction. | | 3 | 电话 | 20 | 文本 | phone | Phone number of the customer. | | 4 | 客户ID | 30 | 文本 | customerId | 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 测试参数 测试小米ID：100019995/test123456 卡号：5123456789012346 有效期：0520 cvv：123 ## 5.7 IPL渠道(跳转） | Parameter | Type | Required | Description | Sample | | ------------ | ---------- | -------- | ------------------------------------------------------------ | ------ | | language | string(2) | O | 显示语言Chinese:zh,English:en,Korean:ko | zh | | terminalType | string(16) | M | 终端类型:web/h5/android/ios | h5 | | transTimeout | string(6) | M | 订单有效时长，整数格式，单位分钟(min) | 10 | | country | string(2) | O | 国家二字代码，需要大写。页面将展示这个国家的支付方式。如果不传，根据系统判定的国家展示支付方式 | CN | 测试卡号： ```javascript Visa： cardNo: 4000020951595032 expirationMonth: 06 expirationYear: 28 cvv: 688 firstName: Ken lastName: Swift Mastercard: cardNo: 5333300989521936 expirationMonth: 06 expirationYear: 28 cvv: 688 firstName: Ken lastName: Swift JCB: cardNo: 3567860000000000 expirationMonth: 06 expirationYear: 28 cvv: 688 firstName: Ken lastName: Swift American Express: cardNo: 375532604034750 expirationMonth: 06 expirationYear: 28 cvv: 6688 firstName: Ken lastName: Swift Diners Club: cardNo: 36259600590707 expirationMonth: 06 expirationYear: 28 cvv: 688 firstName: Ken lastName: Swift Discover: cardNo: 6011492100005191 expirationMonth: 06 expirationYear: 28 cvv: 688 firstName: Ken lastName: Swift ``` ## 5.8 RP渠道(跳转） | Parameter | Type | Required | Description | Sample | | --------- | ------ | -------- | ---------------------------------------------------------- | -------------- | | firstname | string | M | This is name of the customer who is doing the transaction. | jim | | email | string | M | this is email id of the customer who is doing transaction. | 123456@163.com | ```javascript 测试卡号 Domestic Mastercard： 5104_0155_5555_5558, 5104_0600_0000_0008 Visa: 4111_1111_1111_1111 International Mastercard: 5555_5555_5555_4444 5105_1051_0510_5100 Visa: 012_8888_8888_1881 4000_1841_8621_8826 ```