POST
Create quote

Authorizations

x-api-key
string
header
required

Your secret key. It starts with sk_test_ or sk_live_.

Body

application/json
sourceCurrency
enum<string>
required

Source currency — must match a wallet held by the merchant

Available options:
NGN,
GHS,
KES
Example:

"NGN"

destinationCurrency
enum<string>
required

Destination currency — must match a wallet held by the merchant

Available options:
NGN,
GHS,
KES
Example:

"GHS"

amount
number
required

Amount in minor units (kobo, pesewas, cents…) — a positive WHOLE number. There is no half-kobo, so a fractional amount is rejected rather than rounded.

Example:

1000000

transactionType
enum<string>
default:payout

Intent for this quote. Use "conversion" for a wallet-to-wallet FX conversion so an auto (provider-settled) corridor is priced at the provider rate the settlement will actually apply. "payout" (the default) prices a cross-currency payout at the internal rate.

Available options:
payout,
conversion

Response

Quote created — locked for 5 minutes