A withdrawal order debits a fiat amount from your settlement account and transfers it to an outside bank account.

⚠️

Currency Must Match the Settlement Account

The withdrawal currency MUST be the same as your settlement account currency. Requesting a withdrawal in a different currency is rejected.

Withdrawal Destinations

Set the withdrawal.type field to the rail you want to use, then provide the matching object:

Use address_book_item to reference an id of previously loaded arbitrary withdraw instructions. Currently the only way to load these instructions is by manually requesting it to [email protected].

Mexico (MXN) — CLABE Transfer

Withdrawals to a Mexican bank account use the same mx_clabe object as a Customer's outgoing fiat instruction.

{
  "reference_id": "withdrawal-1",
  "operation": "withdrawal",
  "withdrawal": {
    "currency": "MXN",
    "amount": "1234.56",
    "type": "mx_clabe",
    "mx_clabe": {
      "clabe": "123456789012345678",
      "beneficiary_full_name": "Juan Perez"
    }
  }
}