Register an external account

Register an external bank account or wallet before using it as a withdrawal recipient. The account must be owned by the authenticated partner; third-party accounts and wallets are not supported.

The API calls this resource a whitelisted own account and returns its destinationId. Registration creates a reusable destination record; it does not move money.

Register a bank account or wallet

Register a bank account:

POST /whitelisted-own-accounts/bank HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "currency": "USD",
  "accountNumber": "0123456789",
  "swiftBic": "BOFAUS3NXXX",
  "bankName": "Bank of America"
}

Or register a wallet:

POST /whitelisted-own-accounts/wallet HTTP/1.1
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "currency": "USDT",
  "walletAddress": "TNPeeaaFB7K9cmo4uQpcU32zGK8G1NYqeL",
  "network": "TRON"
}

Wait for activation

A newly registered external account starts in PENDING_REVIEW. Retrieve it with GET /whitelisted-own-accounts/{destinationId} until it becomes ACTIVE, or process destination.* webhooks. Do not use a destination that is pending review, suspended, or closed.

Once active, supply the returned destinationId when creating a withdrawal. It is not interchangeable with an Axiym accountId.