Payouts to Hong Kong

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

Supported configurations

Hong Kong payouts support the following participant types:

• C2C (consumer-to-consumer) — individual customer to individual counterparty
• B2C (business-to-consumer) — business customer to individual counterparty
• B2B (business-to-business) — business customer to business counterparty

All three use the bank_account route via the HKBANK payment rail.

Trading account requirement

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

Verify HKD payout availability

Confirm your bank supports HKD payouts for your participant type and the bank_account route.

ℹ️

Bank configuration required

Contact Cybrid support to enable HKD payouts and configure Hong Kong 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: HKD-USD or HKD-USDC_SOL
• country_code: HK
• participants_type: C2C, B2C, or B2B
• route: bank_account

You can also query prices for Hong Kong:

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

Identity verification requirements

The platform validates all required KYC fields when you create a plan for HKD payouts. Requirements
differ by participant type.

Originator (Customer)

Individual originator (C2C):

• name.first, name.last
• date_of_birth
• address.street, address.city, address.country_code

Business originator (B2C, B2B):

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

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 (C2C, B2C): This corridor requires no additional counterparty fields
beyond the platform defaults.

Business counterparty (B2B): This corridor requires no additional counterparty fields beyond
the platform defaults.

Purpose of transaction

For Hong Kong payouts, purpose_of_transaction is required for all participant types. All
standard purpose values are accepted.

Supporting documents

B2B payouts to Hong Kong require at least one supporting document. No specific document type is
mandated, so you can use any supported type: invoice, purchase_order, delivery_slip,
contract, bill_of_lading, or others. C2C and B2C payouts require no supporting documents.

Requirements:

• At least one supporting document is required (B2B only).
• 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.

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

Hong Kong payouts use HKBANK routing. The credit party is identified by a bank account number and
SWIFT/BIC code.

Send a POST request to /api/external_bank_accounts with the following format:

{
  "account_kind": "raw_routing_details",
  "name": "Hong Kong beneficiary account",
  "counterparty_bank_account_details": [{
    "bank_code_type": "SWIFT_BIC",
    "bank_code": "BBDAHKHX",
    "account_identifier": "123456789012",
    "payment_rail": "HKBANK"
  }],
  "counterparty_guid": "counterparty_guid",
  "customer_guid": "customer_guid",
  "asset": "HKD"
}

ℹ️

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.

Supported banks

The following institutions are available for HKD payouts to Hong Kong. Use the SWIFT/BIC code when
setting up the external bank account.

⚠️

Participant type exception

Bank of China (Hong Kong) Limited supports B2B and B2C only — C2C is not available.
All other banks support B2B, B2C, and C2C.

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