China
Learn everything you need to know to make payouts in China with dLocal.
Market specifications
Take a look of all the information you need to make a payout.
Country reference Document validations Mandatory paramentersPayment methods
Find all the information about payment methods capabilities.
Bank transfers - CNY flow Bank transfers - USD flowBank information
Find all the bank account validations details you need to make a payout.
Bank codes - CNY flowMarket specifications
Do you want to know more information about China's market? Go to the Accelerate Growth in Asia’s Leading eCommerce Hubs article.
Country reference
country code | currency code | amount decimals | document_type name | document_id format |
---|---|---|---|---|
CN | CNY | 2 | 公民身份号码 (citizen ID number) | Between 18 digits or 17 digits + letter X |
Mandatory parameters
Bank transfers - CNY flow
Bank transfer parameters | B2C | B2B | P2P |
---|---|---|---|
login | Yes | Yes | Yes |
pass | Yes | Yes | Yes |
external_id | Yes | Yes | Yes |
beneficiary_name | Yes | Yes | Yes |
country | Yes | Yes | Yes |
bank_branch | Yes | Yes | Yes |
bank_account | Yes | Yes | Yes |
account_type | Yes | Yes | Yes |
currency | Yes | Yes | Yes |
amount | Yes | Yes | Yes |
phone | Yes | Yes | Yes |
document_id | Yes | Yes | Yes |
document_type | Yes | Yes | Yes |
purpose | - | Yes | Yes |
remitter_full_name | - | - | Yes |
remitter_document_type | - | - | Yes |
remitter_birth_date | - | - | Yes |
remitter_document | - | - | Yes |
remitter_address | - | - | Yes |
remitter_city | - | - | Yes |
remitter_country | - | - | Yes |
remitter_nationality | - | - | Yes |
Bank transfers - USD flow
Bank transfer parameters | B2C | B2B |
---|---|---|
login | Yes | Yes |
pass | Yes | Yes |
external_id | Yes | Yes |
beneficiary_name | Yes | Yes |
country | Yes | Yes |
bank_branch | Yes | Yes |
bank_account | Yes | Yes |
amount | Yes | Yes |
phone | Yes | Yes |
address | Yes | Yes |
document_id | Yes | Yes |
document_type | Yes | Yes |
currency_to_pay | Yes | Yes |
Payment methods
China supports payouts via Bank transfers. There are two distinct flows depending on the currency: CNY flow and USD flow. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards.
Bank transfers - CNY flow
CNY bank transfers require detailed account information, including beneficiary name (Han characters only), CNAPS code, bank account, account type, and document information.
Mandatory parameters
All fields listed below are required for CNY bank transfer payouts. For successful processing, ensure correct formatting and value types.
Mandatory parameter | Description |
---|---|
login | API authentication credentials. Maximum 32 characters. |
pass | API authentication credentials. Maximum 32 characters. |
external_id | Unique transaction identifier. Maximum 100 characters. |
beneficiary_name | First name of the beneficiary. Maximum 50 characters. Han characters only. |
country | Country code. For China, use CN . |
bank_branch | CNAPS code, 12 digits long. |
bank_account | Bank account number. 15 to 18 digits for credit or debit cards; 9 to 25 digits for bank accounts. |
account_type | Account type. Mandatory only if the account is not a credit or debit card. C : for Checking accounts, S : for Savings accounts. |
currency | Payout currency. For CNY flow, use CNY or USD . |
amount | Payout amount. Use up to 2 decimal numbers. |
phone | Phone number. Maximum 100 characters. |
document_id | Document ID. Resident Identity Card or PASS: max. 100 chars. TAXID: max 18 chars. |
document_type | Document type. Mandatory if document type is PASS or TAXID. |
purpose | Reason for the payout. EPBTOB - Business to Business (B2B), EPREMT - Remittance (P2P). Mandatory only for Business to Business (B2B) and Remittance (P2P). |
remitter_full_name | Full name of the sender. Maximum 100 characters. Mandatory only for remittance (P2P). |
remitter_document_type | Type of identification document: ID for national identification number, PASS for passport. Mandatory only for remittance (P2P). |
remitter_birth_date | Sender’s birth date. Format YYYYMMDD . Mandatory only for remittance (P2P). |
remitter_document | Document number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P). |
remitter_address | Full address of the sender. Maximum 200 characters. Mandatory only for remittance (P2P). |
remitter_city | City of the sender. Maximum 40 characters. Mandatory only for remittance (P2P). |
remitter_country | ISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P). |
remitter_nationality | ISO 3166-1 alpha-2 code of the sender's nationality. Mandatory only for remittance (P2P). |
Example request - CNY flow
{
"login": "1n234n56",
"pass": "HolAc123o",
"external_id": "1234567812345678",
"beneficiary_name": "John Mills",
"country": "CN",
"bank_account": "123456789123456",
"bank_branch": "303513000052",
"amount": "9273.34",
"comments": "this is the 1st comment",
"currency": "CNY",
"phone": "6767658758869",
"document_id": "110102YYYYMMDD888X",
"remitter_birth_date": "19930722",
"extra_info": "{ \"this_is_extra\": 2334 }",
"notification_url": "https://thisisawebsite.net/payments",
"type": "json"
}
Bank transfers - USD flow
USD bank transfers require detailed account information, including beneficiary name (English only), SWIFT code, bank account, address, and document information.
Mandatory parameters
All fields listed below are required for USD bank transfer payouts. For successful processing, ensure correct formatting and value types.
Mandatory parameter | Description |
---|---|
login | API authentication credentials. Maximum 32 characters. |
pass | API authentication credentials. Maximum 32 characters. |
external_id | Unique transaction identifier. Maximum 100 characters. |
beneficiary_name | First name of the beneficiary. Maximum 50 characters. Only English characters are accepted. |
country | Country code. For China, use CN . |
bank_branch | SWIFT code (we accept 8 or 11 alphanumeric characters in upper case). |
bank_account | Bank account number. 15 to 25 digits. |
amount | Payout amount. Use up to 2 decimal numbers. |
phone | Phone number. Maximum 100 characters. |
address | Full address. Maximum 200 characters. |
document_id | Document ID. Resident Identity Card or PASS: max. 100 chars. TAXID: max 18 chars. |
document_type | Document type. Mandatory if document type is PASS or TAXID. |
currency_to_pay | Currency to be paid out: USD . |
Example request - USD flow
{
"login":"1n234n56",
"pass":"HolAc123o",
"external_id":"123456781234567118",
"beneficiary_name":"John Mills",
"country":"CN",
"bank_account":"123456789012345",
"bank_branch": "ABOCCNBJ080",
"amount":"109.44",
"currency":"USD",
"currency_to_pay":"USD",
"phone": "6767658758869",
"document_id": "110102YYYYMMDD888X",
"address": "Street 1157",
"notification_url":"https://thisisawebsite.net/payments",
"type":"json"
}
Bank information
Access the reference formats and accepted values required for processing bank payouts in China.
Bank codes - CNY flow
The banks supported may change according to the payment's flow:
- P2P & B2C flow
- B2B flow
P2P & B2C flow
We support every bank covered by China UnionPay network.
B2B flow
Bank Name | Abbreviation | Bank Code |
---|---|---|
Agricultural Bank of China | ABC | 103 |
Bank of Beijing | BCCB | 792 |
Bank of China | BOC | 001 |
Bank of Communications | BOCOM | 301 |
Bank of Jiangsu | JSCB | 795 |
Bank of Ningbo | NBCB | 791 |
Bank of Shanghai | BOS | 794 |
China Bohai Bank | CBHB | 318 |
China CITIC Bank | CITIC | 302 |
China Construction Bank | CCB | 105 |
China Everbright Bank | CEB | 303 |
China Guangfa Bank | GDB | 789 |
China Merchants Bank | CMB | 308 |
China Minsheng Bank | CMBC | 305 |
China Zheshang Bank | CZB | 316 |
Hengfeng Bank Co. | HFB | 793 |
HSBC Bank | HXB | 790 |
Industrial and Commercial Bank of China | ICBC | 102 |
Industrial Bank Co., Ltd | CIB | 309 |
Ping An Bank | PINGAN | 788 |
Postal Savings Bank of China | PSBC | 403 |
Shanghai Pudong Development Bank | SPDB | 310 |
Updated 4 days ago