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` code	`currency` code	`amount` decimals	`beneficiary.document.type` name	`beneficiary.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
`external_id`	Yes	Yes	Yes
`payment_method_id`	Yes	Yes	Yes
`flow_type`	Yes	Yes	Yes
`purpose`	Yes	Yes	Yes
`country`	Yes	Yes	Yes
`amount`	Yes	Yes	Yes
`currency`	Yes	Yes	Yes
`beneficiary.first_name`	Yes	-	Yes
`beneficiary.last_name`	Yes	-	Yes
`beneficiary.business_name`	-	Yes	-
`beneficiary.document.type`	Yes	Yes	Yes
`beneficiary.document.id`	Yes	Yes	Yes
`beneficiary.bank_account.code`	Yes	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes	Yes
`beneficiary.bank_account.type`	Yes	Yes	Yes
`beneficiary.phone`	Yes	Yes	Yes
`remitter.first_name`	-	-	Yes
`remitter.last_name`	-	-	Yes
`remitter.document.type`	-	-	Yes
`remitter.document.id`	-	-	Yes
`remitter.birth_date`	-	-	Yes
`remitter.address.street`	-	-	Yes
`remitter.address.city`	-	-	Yes
`remitter.address.country`	-	-	Yes
`remitter.nationality`	-	-	Yes

Bank transfers - USD flow

Bank transfer parameters	B2C	B2B
`external_id`	Yes	Yes
`payment_method_id`	Yes	Yes
`flow_type`	Yes	Yes
`purpose`	Yes	Yes
`country`	Yes	Yes
`amount`	Yes	Yes
`currency`	Yes	Yes
`currency_to_pay`	Yes	Yes
`beneficiary.first_name`	Yes	-
`beneficiary.last_name`	Yes	-
`beneficiary.business_name`	-	Yes
`beneficiary.document.type`	Yes	Yes
`beneficiary.document.id`	Yes	Yes
`beneficiary.bank_account.code`	Yes	Yes
`beneficiary.bank_account.account`	Yes	Yes
`beneficiary.phone`	Yes	Yes
`beneficiary.address.street`	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
`external_id`	Unique payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method identifier. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For China, use `CN`.
`amount`	Payout amount. Use up to 2 decimal places.
`currency`	Source currency of the FX operation. For China CNY flow, use `CNY`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters. Han characters only.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters. Han characters only.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.document.type`	Beneficiary's document type. Use `CUI` for Resident Identity Card, `PASS` for passport, or `TAXID` for tax ID.
`beneficiary.document.id`	Beneficiary's document number. For `CUI`: maximum 100 characters. For `TAXID`: maximum 18 characters.
`beneficiary.bank_account.code`	Bank code. CNAPS code. Must be 12 digits long.
`beneficiary.bank_account.account`	Bank account number. 15 to 18 digits for credit/debit cards or 9 to 25 digits for bank accounts.
`beneficiary.bank_account.type`	Beneficiary's bank account type. Account type: `CHECKING`: Checking accounts `SAVINGS`: Savings accounts
`beneficiary.phone`	Beneficiary's phone number. Maximum 100 characters.
`remitter.first_name`	Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.last_name`	Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P).
`remitter.document.type`	Remitter's document type. Use `ID` for national identification number, `PASS` for passport. Mandatory only for remittance (P2P).
`remitter.document.id`	Remitter's document number. Maximum 45 characters. Mandatory only for remittance (P2P).
`remitter.birth_info.date`	Remitter's birth date. Format `YYYY-MM-DD`. Mandatory only for remittance (P2P).
`remitter.address.street`	Remitter's street address. Maximum 200 characters. Mandatory only for remittance (P2P).
`remitter.address.city`	Remitter's city. Maximum 40 characters. Mandatory only for remittance (P2P).
`remitter.address.country`	Remitter's country code in ISO 3166-1 alpha-2 format. Mandatory only for remittance (P2P).
`remitter.nationality`	Remitter's nationality in ISO 3166-1 alpha-2 format. Mandatory only for remittance (P2P).

Example request - CNY flow

{
  "external_id": "VT9B2N1U3O-FUV98",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "CN",
  "amount": 9273.34,
  "currency": "CNY",
  "beneficiary": {
    "first_name": "张",
    "last_name": "三",
    "document": {
      "id": "460106200408180419"
    },
    "bank_account": {
      "branch": "303513000052",
      "account": "120101198302051053",
      "type": "SAVINGS"
    },
    "phone": "+866767658758869"
  }
}

{
  "external_id": "VT9B2N1U3O-FUV99",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2B",
  "purpose": "OTHER_SERVICES",
  "country": "CN",
  "amount": 9273.34,
  "currency": "CNY",
  "beneficiary": {
    "business_name": "信息技术有限公司",
    "document": {
      "id": "14010619890614183X"
    },
    "bank_account": {
      "branch": "303513000052",
      "account": "120101198302051053",
      "type": "SAVINGS"
    },
    "phone": "+866767658758869"
  }
}

{
    "external_id": "VT9B2N1U3O-FUV100",
    "payment_method_id": "BANK_TRANSFER",
    "flow_type": "P2P",
    "purpose": "REMITTANCES",
    "country": "CN",
    "amount": 5273.34,
    "currency": "CNY",
    "beneficiary": {
        "business_name": "信息技术有限公司",
        "document": {
            "id": "14010619890614183X"
        },
        "bank_account": {
            "branch": "303513000052",
            "account": "120101198302051053",
            "type": "SAVINGS"
        },
        "phone": "+866767658758869"
    },
    "remitter": {
        "first_name": "Jane",
        "last_name": "Smith",
        "document": {
            "type": "PASS",
            "id": "P1234567"
        },
        "birth_info": {
            "date": "1982-06-15"
        },
        "address": {
            "street": "123 Main St",
            "city": "New York",
            "country": "US"
        },
        "nationality": "US"
    }
}

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
`external_id`	Unique payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id`	Payment method identifier. For bank transfers, use `BANK_TRANSFER`.
`flow_type`	Payout flow type. Valid values: `B2C` (Business to Consumer) or `B2B` (Business to Business).
`purpose`	Payout purpose code. See purpose codes reference.
`country`	Country code. For China, use `CN`.
`amount`	Payout amount. Use up to 2 decimal places.
`currency`	Source currency of the FX operation. For China USD flow, use `USD`.
`currency_to_pay`	Currency to be paid out. Use `USD`.
`beneficiary.first_name`	Beneficiary's first name. Maximum 50 characters. English characters only.
`beneficiary.last_name`	Beneficiary's last name. Maximum 50 characters. English characters only.
`beneficiary.business_name`	Beneficiary's business name. Mandatory only for B2B.
`beneficiary.document.type`	Beneficiary's document type. Use `CUI` for Resident Identity Card, `PASS` for passport, or `TAXID` for tax ID.
`beneficiary.document.id`	Beneficiary's document number. For `CUI`: maximum 100 characters. For `TAXID`: maximum 18 characters.
`beneficiary.bank_account.code`	Bank code. CNAPS code. Must be 12 digits long.
`beneficiary.bank_account.account`	Bank account number. 15 to 18 digits for credit/debit cards or 9 to 25 digits for bank accounts.
`beneficiary.phone`	Beneficiary's phone number. Maximum 100 characters.
`beneficiary.address.street`	Beneficiary’s address. Maximum 200 characters.

Example request - USD flow

{
  "external_id": "VT9B2N1U3O-FUV101",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2C",
  "purpose": "OTHER_SERVICES",
  "country": "CN",
  "amount": 5273.34,
  "currency": "USD",
  "currency_to_pay": "USD",
  "beneficiary": {
    "first_name": "Zyiang",
    "last_name": "Zheng",
    "document": {
      "id": "342501198810205818"
    },
    "bank_account": {
      "branch": "ICBKCNBJXXX",
      "account": "0200002901000680000"
    },
    "phone": "+866767658758872",
    "address": {
      "street": "88 Jianguo Road, Beijing, 100010, China"
    }
  }
}

{
  "external_id": "VT9B2N1U3O-FUV102",
  "payment_method_id": "BANK_TRANSFER",
  "flow_type": "B2B",
  "purpose": "OTHER_SERVICES",
  "country": "CN",
  "amount": 15273.34,
  "currency": "USD",
  "currency_to_pay": "USD",
  "beneficiary": {
    "business_name": "Technology Inc.",
    "document": {
      "id": "342501198810205818"
    },
    "bank_account": {
      "branch": "ICBKCNBJXXX",
      "account": "0200002901000680000"
    },
    "phone": "+866767658758872",
    "address": {
      "street": "88 Jianguo Road, Beijing, 100010, China"
    }
  }
}

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