Sign in

v1

latestOpenAPI 3.0.22026-07-26123510445.2 KB
Transfers

Create Transfer

Creates a new internal transfer between accounts, typically used for moving funds between a master account and its sub-accounts under the Banking system.
Please note: this API is only applicable to Banking-related accounts, and does not apply to internal transfers within the Issuing system

post/v1/transfer

Headers

x-idempotency-keystring uuid

A unique identifier (UUID) used to maintain operation idempotency, ensuring that repeated executions of the same operation do not result in unintended effects or duplication. It helps preserve data consistency in the face of network errors, retries, or failures.

Request body

currencystring required

Wallet currency for this transfer. Only XUSD is supported.

amountstring required

Amount for this transfer

type4001 required

Transfer type. Only 4001 (transfer out to the Issuing account) is supported.

reasonstring

Transaction remark

Example request

{
  "currency": "XUSD",
  "amount": "100.50",
  "type": 4001,
  "reason": "Business transfer"
}

Response

Transfer creation successfully.

codeinteger required
messagestring required

Example response

{
  "code": 200,
  "message": "Success",
  "data": {
    "order_id": "3c9e22ba-7b5e-4b7c-b92e-197d0406b86b",
    "short_order_id": "TO260123-JZBHC9IA",
    "order_status": "Pending",
    "order_type": "Transfer Out",
    "amount": 100,
    "currency": "USD",
    "reason": "testAPI",
    "create_time": "2026-01-23 13:12:27 +08:00"
  }
}