Create a payout
Disperses fiat to a local bank account. The local amount converts to USDT at your account’s rate (the same one returned by GET /v1/rates); usdt_amount plus the fixed fee (when configured) is debited and held until the dispersal completes. If it fails, the full debit is refunded.
Pay from any balance: by default the debit comes from your account’s default settlement asset (USDT unless changed via PUT /v1/settlement). Send settlement_asset (USDT, USDC, BTC or GOLD) to pay this specific operation from another balance: the USDT total converts to that asset at the effective settlement price of the moment (see the settlement block in GET /v1/rates) and the debit, hold and — if it fails — the refund all live in that asset for the exact same amount. If the execution price for BTC/GOLD is unavailable the request returns 503 pricing_unavailable; volatile assets also have a per-operation limit (422 settlement_limit_exceeded).
Requires an idempotency key (body field or Idempotency-Key header). Retrying with the same key returns the original payout (200 with idempotency_hit: true).
Authorizations
Session JWT (from register/login) or API key (pk_...).
X-API-Key: <token> is accepted as an alternative header.
Headers
Alternative to the idempotency_key body field.
Body
ISO 3166-1 alpha-2 destination country (e.g. CL, PE, MX).
Local currency (e.g. CLP, PEN, MXN).
Local currency amount as a positive decimal string.
"50000.00"
Payout method from GET /v1/payouts/methods (e.g. bank_transfer).
Destination account details. Required keys depend on the
country and method; see GET /v1/payouts/methods and
GET /v1/payouts/banks. Examples: RUT + bank in Chile, CLABE in
Mexico, CCI in Peru. Brazil PIX: pix_key + pix_key_type (cpf,
cnpj, phone, email, evp), or a bank account without key using
bank_code (ISPB) + branch_code + account_number + tax_id.
Ecuador (remittance corridor): document_value (cédula) plus the
sender's data flat in the same object (sender_name,
sender_document_value, ...); optional structured names
(given_name, first_surname, ... and their sender_* pairs)
take precedence over the automatic split of name.
Use the contact's most recent saved beneficiary for this country (and method, when sent) instead of typing beneficiary again. An explicit beneficiary always wins; 422 no_saved_destination if the contact has none.
The beneficiary is saved as a contact automatically; send false to skip it.
Virtual balance to debit for this operation. Omit to use your account's default settlement asset (USDT unless changed via PUT /v1/settlement).
USDT, USDC, BTC, GOLD Response
Idempotency replay of an existing payout.
Your account's rate at execution time (local units per 1 USDT).
Virtual balance the operation was actually debited from.
USDT, USDC, BTC, GOLD Exact amount debited from the settlement asset's balance (in that asset's units). Equals total_debit when the asset is USDT. If the payout fails this exact amount is refunded — never re-quoted.
Effective USD price per unit of the settlement asset used to convert the USDT total ("1" for USDT/USDC).
pending, processing, completed, failed Present (true) when the response is an idempotent replay.