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,
bank_country and bank_code (ABA routing number for
ach/wire, SWIFT BIC for swift); account_type
(CHECKING/SAVING) is required for ach. The beneficiary
may live in ANY country (country_code is free — e.g. an ACH
to a US bank for someone living in Germany); state is
required only when country_code is US. The receiving bank
must be in the US for ach/wire (bank_country: "US" — the
domestic rails do not pay banks abroad) along with its full
address block (bank_address, bank_city, bank_postal_code,
and bank_state for US banks); for swift the bank address
block is optional (the rail derives it from the BIC) and
bank_country may be any country. Annex-B jurisdictions
(CU/IR/KP/SY) stay blocked for both the beneficiary and the
bank country (422 prohibited_country). Every USD bank-rail
transfer also requires a supporting document (invoice/receipt)
uploaded first via POST /v1/payouts/documents — see the
payout guide.
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 Bank/rail transaction reference (e.g. the bank's transfer id, which the beneficiary can use to cross-check the payment with their bank). On US ACH/wire/SWIFT it is the CBF reference returned immediately at create; on other corridors it stays empty until the rail reports it.
Present (true) when the response is an idempotent replay.