Accounts and destinations
Every withdrawal connects two different resources.
Axiym account
The Axiym account is the funding source. Retrieve it before creating a withdrawal and confirm its status, currency, and available balance.
Whitelisted own account
A whitelisted own account is an external bank account or wallet address owned
by your organization and registered with Axiym. It is selected by
destinationId. Third-party accounts are not supported.
Register an external bank account with POST /whitelisted-own-accounts/bank or
an external wallet with POST /whitelisted-own-accounts/wallet. A destination
starts in PENDING_REVIEW and must become ACTIVE before it can receive a
withdrawal. Use the Account API to retrieve its current status before creating
the withdrawal, or handle destination.* webhooks.
Compatibility checks
Before creating a withdrawal, confirm that:
- both resources are active;
- the source account has enough balance for the amount and applicable fee;
- the destination supports the source account currency; and
- bank or blockchain routing details match the intended route.
Do not treat accountId and destinationId as interchangeable. One identifies
the Axiym balance; the other identifies the approved external recipient.