Payouts to China

Review these China-specific requirements before initiating CNY payouts. For the general cross-border
payment flow, see Sending Cross-Border Payments.

Supported configurations

China payouts support the following participant types, each tied to a specific route:

• B2B (business-to-business) — business customer to business counterparty, via the
  bank_account route on the CNBANK payment rail
• B2C (business-to-consumer) — business customer to individual counterparty, via the
  mobile_wallet route on the ALIPAY payment rail

Unlike other corridors, route and participant type are not independently selectable: bank_account
is available for B2B only, and mobile_wallet is available for B2C only.

Trading account requirement

China payouts require a USDC_SOL trading account as the source. Other trading account types
(such as USDC or USDC_NPL) are not supported for CNY payouts.

Verify CNY payout availability

Confirm your bank supports CNY payouts for your participant type and route.

ℹ️

Bank configuration required

Contact Cybrid support to enable CNY payouts and configure China as a supported corridor for your bank.

GET /api/banks/{bank_guid}
Authorization: Bearer YOUR_TOKEN

Look for an entry in supported_payout_symbols where:

• symbol: CNY-USD or CNY-USDC_SOL
• country_code: CN
• participants_type: B2B or B2C
• route: bank_account or mobile_wallet

Each entry pairs a single participant type with a single route: B2B entries carry
route: bank_account, and B2C entries carry route: mobile_wallet.

You can also query prices for China:

GET /api/prices?payout_country_code=CN
Authorization: Bearer YOUR_TOKEN

Identity verification requirements

The platform validates all required KYC fields when you create a plan for CNY payouts.

Originator (Customer)

Business originator (B2B, B2C):

• name.full (registered name)
• address.street, address.city, address.country_code
• identification_numbers with one of:
  • tax_identification_number
  • business_registration_number
  • employer_identification_number

ℹ️

Business name normalization

For CNY payouts, registered business names are normalized before being sent to the payer: & is
replaced with and, periods and commas are removed, and the name is truncated to 50 characters.
This applies to both the originating and receiving business name.

Receiver (Counterparty)

Create the counterparty with the
standard required fields
for the appropriate type. The counterparty must be in verified state before you can create the
external bank account and plan.

Individual counterparty (B2C, via the AliPay mobile wallet): This corridor requires no
additional counterparty fields beyond the platform defaults.

Business counterparty (B2B, via bank_account):

• name.full
• address.street, address.city, address.country_code

Purpose of transaction

Requirements for purpose_of_transaction depend on the participant type:

• B2C — required. Accepted values: advertising_expenses, advisory_fees,
  construction_expenses, liberalized_remittance, property_rental, salary_payment,
  service_charges, tax_payment.
• B2B — required. Accepted values: travel, hotel_accommodation, delivery_fees,
  commission_on_goods, commission_on_services, accounting_services, exhibition_services,
  office_expenses, exported_goods. Each B2B purpose has its own required document combination —
  see Supporting documents.

Supporting documents

B2B payouts to China require at least one supporting document, and the specific document types
required depend on purpose_of_transaction. B2C payouts require no supporting documents.

Each B2B plan must include exactly one supporting document that carries a document_reference_number.

{
  "supporting_documents": [
    {
      "type": "invoice",
      "file_guids": ["file_guid"],
      "document_reference_number": "INV-1001"
    }
  ]
}

Required documents by purpose

Requirements:

• At least one supporting document is required (B2B only), matching the combination for the
  selected purpose_of_transaction.
• Accepted document types: invoice, purchase_order, delivery_slip, contract,
  bill_of_lading, others.
• Up to 3 documents per plan.
• Each file must be uploaded with a type matching the document type.
• Allowed file formats: application/pdf, image/jpeg, image/png.
• Each file must be no larger than 8 MB, with a filename of 64 characters or fewer.
• Exactly one supporting document must carry a document_reference_number.

Upload each file via File Upload and wait for
state: completed before referencing its GUID. For the full supporting_documents field
structure, see
Sending Cross-Border Payments.

External bank account setup

China payouts use two distinct routing formats depending on participant type and route.

Send a POST request to /api/external_bank_accounts with one of the following formats.

Bank account (B2B)

Uses SWIFT/BIC routing with bank_code_type: SWIFT_BIC and payment_rail: CNBANK.

{
  "account_kind": "raw_routing_details",
  "name": "Chinese beneficiary account",
  "counterparty_bank_account_details": [{
    "bank_code_type": "SWIFT_BIC",
    "bank_code": "ICBKCNBJ",
    "account_identifier": "1234567890123456",
    "payment_rail": "CNBANK"
  }],
  "counterparty_guid": "counterparty_guid",
  "customer_guid": "customer_guid",
  "asset": "CNY"
}

Mobile wallet — AliPay (B2C)

Uses account_identifier_type: PHONE_NUMBER with an E.164 phone number and
payment_rail: ALIPAY. Omit bank_code and bank_code_type — the wallet is reached by phone
number (msisdn), not a bank code.

{
  "account_kind": "raw_routing_details",
  "name": "Chinese beneficiary AliPay wallet",
  "counterparty_bank_account_details": [{
    "account_identifier": "+8613800000000",
    "account_identifier_type": "PHONE_NUMBER",
    "payment_rail": "ALIPAY"
  }],
  "counterparty_guid": "counterparty_guid",
  "customer_guid": "customer_guid",
  "asset": "CNY"
}

ℹ️

API versioning

Creating external bank accounts with foreign raw routing details requires
Accept-Version: 2025-10-01 or later.

For the full account model and field reference, see
Create Foreign Fiat External Bank Accounts.

Validation rules

• SWIFT/BIC: Standard 8 or 11 alphanumeric characters per ISO 9362
• Bank account number: Must be 16 to 19 digits
• Bank code type: Must be SWIFT_BIC for CNBANK; omit bank_code and bank_code_type
  for ALIPAY
• AliPay phone number: Must be a Chinese mobile number in E.164 format — +86 followed by
  11 digits beginning with 1, where the second digit is 3 through 9
• Payment rail: Must be CNBANK for bank account payouts or ALIPAY for mobile wallet payouts

Supported banks and mobile wallets

Bank account

The following 461 institutions are available for CNY payouts to China via the bank_account route
(B2B only). Use the SWIFT/BIC code when setting up the external bank account.

Mobile wallet

The ALIPAY route is available in sandbox for B2C payouts. Contact Cybrid support to enable it
for your bank in production.

Common validation errors

Related resources

• Sending Cross-Border Payments
• Create Foreign Fiat External Bank Accounts
• Creating a Counterparty
• Verifying a Counterparty
• Create Plan API Reference