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 paramenters

Payment methods

Find all the information about payment methods capabilities.

Bank transfers - CNY flow Bank transfers - USD flow

Bank information

Find all the bank account validations details you need to make a payout.

Bank codes - CNY flow

Market 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 codecurrency codeamount decimalsdocument_type namedocument_id format
CNCNY2公民身份号码
(citizen ID number)
Between 18 digits or 17 digits + letter X

Mandatory parameters

Bank transfers - CNY flow

Bank transfer parametersB2CB2BP2P
loginYesYesYes
passYesYesYes
external_idYesYesYes
beneficiary_nameYesYesYes
countryYesYesYes
bank_branchYesYesYes
bank_accountYesYesYes
account_typeYesYesYes
currencyYesYesYes
amountYesYesYes
phoneYesYesYes
document_idYesYesYes
document_typeYesYesYes
purpose-YesYes
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 parametersB2CB2B
loginYesYes
passYesYes
external_idYesYes
beneficiary_nameYesYes
countryYesYes
bank_branchYesYes
bank_accountYesYes
amountYesYes
phoneYesYes
addressYesYes
document_idYesYes
document_typeYesYes
currency_to_payYesYes

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 parameterDescription
loginAPI authentication credentials. Maximum 32 characters.
passAPI authentication credentials. Maximum 32 characters.
external_idUnique transaction identifier. Maximum 100 characters.
beneficiary_nameFirst name of the beneficiary. Maximum 50 characters. Han characters only.
countryCountry code. For China, use CN.
bank_branchCNAPS code, 12 digits long.
bank_accountBank account number. 15 to 18 digits for credit or debit cards; 9 to 25 digits for bank accounts.
account_typeAccount type. Mandatory only if the account is not a credit or debit card. C: for Checking accounts, S: for Savings accounts.
currencyPayout currency. For CNY flow, use CNY or USD.
amountPayout amount. Use up to 2 decimal numbers.
phonePhone number. Maximum 100 characters.
document_idDocument ID. Resident Identity Card or PASS: max. 100 chars. TAXID: max 18 chars.
document_typeDocument type. Mandatory if document type is PASS or TAXID.
purposeReason for the payout. EPBTOB - Business to Business (B2B), EPREMT - Remittance (P2P). Mandatory only for Business to Business (B2B) and Remittance (P2P).
remitter_full_nameFull name of the sender. Maximum 100 characters. Mandatory only for remittance (P2P).
remitter_document_typeType of identification document: ID for national identification number, PASS for passport. Mandatory only for remittance (P2P).
remitter_birth_dateSender’s birth date. Format YYYYMMDD. Mandatory only for remittance (P2P).
remitter_documentDocument number of the sender. Maximum 45 characters. Mandatory only for remittance (P2P).
remitter_addressFull address of the sender. Maximum 200 characters. Mandatory only for remittance (P2P).
remitter_cityCity of the sender. Maximum 40 characters. Mandatory only for remittance (P2P).
remitter_countryISO 3166-1 alpha-2 code of the sender. Mandatory only for remittance (P2P).
remitter_nationalityISO 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 parameterDescription
loginAPI authentication credentials. Maximum 32 characters.
passAPI authentication credentials. Maximum 32 characters.
external_idUnique transaction identifier. Maximum 100 characters.
beneficiary_nameFirst name of the beneficiary. Maximum 50 characters. Only English characters are accepted.
countryCountry code. For China, use CN.
bank_branchSWIFT code (we accept 8 or 11 alphanumeric characters in upper case).
bank_accountBank account number. 15 to 25 digits.
amountPayout amount. Use up to 2 decimal numbers.
phonePhone number. Maximum 100 characters.
addressFull address. Maximum 200 characters.
document_idDocument ID. Resident Identity Card or PASS: max. 100 chars. TAXID: max 18 chars.
document_typeDocument type. Mandatory if document type is PASS or TAXID.
currency_to_payCurrency 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 NameAbbreviationBank Code
Agricultural Bank of ChinaABC103
Bank of BeijingBCCB792
Bank of ChinaBOC001
Bank of CommunicationsBOCOM301
Bank of JiangsuJSCB795
Bank of NingboNBCB791
Bank of ShanghaiBOS794
China Bohai BankCBHB318
China CITIC BankCITIC302
China Construction BankCCB105
China Everbright BankCEB303
China Guangfa BankGDB789
China Merchants BankCMB308
China Minsheng BankCMBC305
China Zheshang BankCZB316
Hengfeng Bank Co.HFB793
HSBC BankHXB790
Industrial and Commercial Bank of ChinaICBC102
Industrial Bank Co., LtdCIB309
Ping An BankPINGAN788
Postal Savings Bank of ChinaPSBC403
Shanghai Pudong Development BankSPDB310