Quotes
All payouts start with a quote. A quote calculates the local-currency amount delivered to the receiver and fixes the financial terms used by the payout.
What a quote fixes
A quote contains:
- the funding account and origin country;
- sell and buy amounts and currencies;
- the destination country and payout method;
- the exchange rate and fee;
- the total amount debited from the funding account; and
- the time at which the quote expires.
The quote is the immutable source of the payout's amounts and currencies. Do not repeat or recalculate those values in the payout request.
Sell and buy amount basis
Use amountBasis to state which side of the quote the requested amount
represents.
| Value | Meaning |
|---|---|
sell | Fix the amount sold from the funding account, excluding the fee. |
buy | Fix the local-currency amount bought and delivered to the receiver. |
The sell currency is derived from accountId. The buy currency must be a
fiat currency supported by the selected corridor.
Quote lifecycle
| Status | Meaning |
|---|---|
ACTIVE | Available for one payout to be prepared and confirmed until expiresAt. |
EXPIRED | Its time-to-live elapsed before use. |
USED | It was consumed when its prepared payout was confirmed. |
CANCELED | It is no longer valid for payout creation or confirmation. |
Rates can change materially with time and amount, so each quote has a limited
time-to-live. The TTL can vary by corridor. Always use the returned expiresAt
rather than assuming a fixed duration.
A payout cannot be created from an invalid quote. A prepared payout must also be confirmed before the quote expires; otherwise it expires without moving funds.
Example
{
"quoteId": "978490c4-4227-4a75-9820-5f90482bb78b",
"accountId": "d96b90c1-b69e-4f5d-8154-46ecfcad8d0a",
"status": "ACTIVE",
"originCountry": "SG",
"destinationCountry": "PH",
"payoutMethod": "BANK",
"sell": { "amount": "1000.00", "currency": "USD" },
"buy": { "amount": "56500.00", "currency": "PHP" },
"fee": { "amount": "10.00", "currency": "USD" },
"totalPayable": { "amount": "1010.00", "currency": "USD" },
"rate": { "base": "USD", "quote": "PHP", "rate": "56.5000" },
"requestedAt": "2026-08-04T05:07:00Z",
"expiresAt": "2026-08-04T05:08:00Z"
}