Payments

Payouts

Send money to your bank or to sellers and suppliers in 40+ currencies, on a schedule or on demand, and track each transfer.

A payout moves money from your International Orders balance to a bank account. Use payouts to settle your own funds, or to pay sellers, suppliers and partners around the world.

This is preview documentation for a prototype. Endpoints, fields and keys are illustrative.

Automatic payouts

By default, your available balance is paid to your main bank account on a schedule. Choose daily, weekly or monthly in the dashboard. Funds become available after a short settlement delay that depends on the payment method and your account.

You don't need any code for automatic payouts. You receive payout.created and payout.paid events for each one.

Send a payout

To pay someone else, or to pay yourself on demand, create a payout:

curl https://api.international-orders.com/v1/payouts \
  -u sk_test_51Hx...: \
  -H "Idempotency-Key: supplier-inv-5531" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 250000,
    "currency": "MXN",
    "source_currency": "USD",
    "destination": {
      "type": "bank_account",
      "country": "MX",
      "account_holder_name": "Textiles del Norte SA",
      "clabe": "032180000118359719"
    },
    "description": "Invoice 5531"
  }'

{
  "id": "po_5Qw1vZ8hN3yD",
  "object": "payout",
  "status": "pending",
  "amount": 250000,
  "currency": "MXN",
  "source_currency": "USD",
  "source_amount": 13842,
  "fx_rate": "18.0610",
  "arrival_date": "2026-10-03",
  "created": "2026-10-01T09:14:22Z"
}

amount is what the recipient gets. We convert from source_currency at the rate shown and debit source_amount from your balance. Lock a rate in advance with Multi-Currency and FX.

Bank details by country

Each country uses its own account format. The API validates details before sending.

Country	Required fields
Eurozone	`iban`
United Kingdom	`sort_code`, `account_number`
United States	`routing_number`, `account_number`, `account_type`
Mexico	`clabe`
India	`ifsc`, `account_number`
Australia	`bsb`, `account_number`

Invalid details return 400 with the code invalid_bank_account before any money moves. See Errors.

Payout status

Status	Meaning
`pending`	Created, waiting to be sent
`in_transit`	Sent to the local payment network
`paid`	The receiving bank has accepted it
`failed`	Rejected. Funds return to your balance
`cancelled`	Cancelled before sending

You can cancel a payout while it's pending. Once it's in_transit, it can only be returned by the recipient's bank.

When payouts fail

A failed payout includes a failure_code, such as account_closed or name_mismatch. The money returns to your balance, in the source currency, within a few business days. Correct the details and send a new payout.