Idempotency

Write endpoints that create customers, quotes, payins, payouts, transfers, or transfer relaunches require an Idempotency-Key header.

Idempotency-Key: payin_2026_06_08_0001

Required endpoints

Endpoint	Purpose
`POST /customers`	Create customer
`POST /quotes/payin`	Create payin quote
`POST /quotes/payout`	Create payout quote
`POST /quotes/transfer`	Create transfer quote
`POST /payins`	Create payin
`POST /payouts`	Create payout
`POST /transfers`	Create transfer
`POST /transfers/{id}/relaunch-payout`	Relaunch failed transfer disbursement

Use a unique key for each distinct business intent.
Reuse the same key only when retrying the exact same request body after a timeout or network error.
Use a new key when creating a new payment, quote, customer, or transfer.

When a request is replayed successfully, the API marks the response metadata:

{
  "_meta": {
    "idempotency_key": "payin_2026_06_08_0001",
    "idempotency_replayed": true
  }
}

Last modified on July 8, 2026