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.
Argentina: tax_id (11-digit CUIT/CUIL) + account_number
(22-digit CBU or CVU; USD is CBU-only) — no bank_code.
United States (USD): full beneficiary identity and postal address
on every transfer — name, email, account_number,
country_code, address, city, postal_code, bank_name and
bank_code (ABA routing number for ach/wire, SWIFT BIC for
swift); account_type (CHECKING/SAVING) is required for
ach. The receiving bank's address block and bank_phone are
optional but recommended.
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.