Skip to main content
POST
Get Quote
Request a quote to preview the exchange rate, fees, and final amount before executing a payout.

Parameters

string
required
The token returned from the Lookup endpoint. Valid for 10 minutes.
number
required
Amount to send from your merchant wallet. Must be greater than 0.
string
required
ISO 4217 currency code of your merchant wallet (e.g. EUR, USD, XAF). Max 10 characters.
string
required
ISO 4217 currency code of the recipient’s target wallet (e.g. XAF, USD). Max 10 characters. Must match one of the currencies returned in the lookup response.

Example Request

Success Response 200

string
UUID identifying this quote. Pass it to the Payout endpoint to lock in this rate. Valid for 5 minutes.
number
The amount that will be sent (before fees).
string
The currency being sent from your merchant wallet.
string
The currency the recipient will receive.
number
The applied exchange rate from sender_currency to receiver_currency.
number
The total fee charged (fixed + percentage). Debited from your merchant wallet in sender_currency.
number
Total amount debited from your merchant wallet (amount + fee).
number
The amount the recipient will receive in their wallet.
string
ISO 8601 timestamp when this quote expires.

Same-Currency Example

When sending and receiving currencies match, the exchange rate is 1.0:

Error Responses

Quotes expire after 5 minutes. If a quote expires, request a new one before executing the payout.