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 B2B (business-to-business) only — business customer to business counterparty, via the bank_account route on the CNBANK payment rail.

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 B2B payouts via the bank_account 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
• route: bank_account

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):

• 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.

Business counterparty (B2B):

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

Purpose of transaction

purpose_of_transaction is required for B2B payouts. Accepted values: travel, hotel_accommodation, delivery_fees, commission_on_goods, commission_on_services, accounting_services, exhibition_services, office_expenses, exported_goods. Each 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.

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

Send a POST request to /api/external_bank_accounts with SWIFT/BIC routing on the CNBANK payment rail. Set 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"
}

ℹ️

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
• Payment rail: Must be CNBANK

Supported banks

The following 461 institutions are available for CNY payouts to China. Use the SWIFT/BIC code when setting up the external bank account.

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