Create a withdrawal

Before submitting

Confirm that the source account and whitelisted own account are active, compatible, and belong to the authenticated partner. Confirm sufficient balance for the amount and applicable fee.

Create the instruction

Call POST /withdrawals with the source accountId, amount, destinationId, purpose, and your stable external reference. Follow the API Reference for the exact contract.

Use one idempotency key for one withdrawal intent. Persist the key before the request and reuse it only when retrying the identical operation.

Creation submits the withdrawal for execution; there is no separate confirmation step. Persist the returned withdrawalId, initial status, external reference, request ID, and idempotency key before continuing.