Sign in

v1

latestOpenAPI 3.0.12026-07-24128351404.9 KB
Transfer

Different-Account business transfer

Transfer funds between accounts of different users (cross-business transfer) When to call this API
Call /transfer/external when the payer and payee belong to two different platform accounts
(different accountIds).
Note: The minimum amount per CRYPTO_CONNECT transaction is 0.5 USD, USDC, or USDT.
Example:
- Account A (a merchant) pays 500 USD to Account B (a personal user)
- A marketplace collects 100 EUR commission from the seller’s account and sends it to the marketplace’s own account
limits: if payer and payee account are crypto accounts ， support transfer between sub-wallet and master wallet（for the same currency）

if payer and payee account are infinity Accounts， support transfers between master merchant account and sub-merchant account/end-customer account (for the same currency)

post/open-api/v3/business/transfer/external

Request body

clientTransactionIdstring required

Idempotency key provided by the client to ensure uniqueness of the transfer request

amountstring required

Total transfer amount (Including handling fees). Fraction digits depend on currency precision: USDC / USDT / WUSD: up to 6 decimal places; ETH / BTC: up to 8 decimal places; default to 2 decimal places.

Example request

{
  "clientTransactionId": "d84a92b5-8fb9-4052-80a3-1b1594ebcf84",
  "amount": "100",
  "from": {
    "id": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a525",
    "currency": "USD",
    "businessType": 1
  },
  "to": {
    "id": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a525",
    "currency": "USD",
    "businessType": 1
  }
}

Response

success

codestring

Business code, 000000 means success

messagestring

Message description

Example response

{
  "code": "000000",
  "message": "success",
  "data": {
    "clientTransactionId": "d84a92b5-8fb9-4052-80a3-1b1594ebcf84",
    "id": "1965738216225083393",
    "createTime": "1768010400000",
    "completedTime": "1768010400000",
    "from": {
      "id": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a525",
      "transferId": "d84a92b5-8fb9-4052-80a3-1b1594ebcf84",
      "parentAccountId": "dddaef0d-265f-484f-9b42-60175aa6f80e",
      "accountId": "a78b8771-5329-4829-88ce-7db14b3b1d0b",
      "amount": "100",
      "rate": "1",
      "currency": "USD",
      "businessType": 1,
      "fees": [
        {
          "amount": "10",
          "currency": "USD"
        }
      ]
    },
    "to": {
      "id": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a525",
      "parentAccountId": "dddaef0d-265f-484f-9b42-60175aa6f80e",
      "accountId": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a524",
      "transferId": "c6c6e3c4-6114-4f73-ac39-a4ca3d67a5253",
      "amount": "100",
      "currency": "USD",
      "businessType": 1,
      "fees": [
        {
          "amount": "10",
          "currency": "USD"
        }
      ]
    },
    "status": "CLOSED"
  }
}