Create a quote
POST /v1/quotes
What the quote is for:
payout or conversion. Set conversion when you will use the quote for
a wallet-to-wallet conversion.Response · 201
Payve’s fee.
fee.amount is in minor units of fee.currency. It can also carry a structure
object describing how the fee is worked out.What you pay
The fee is charged on top of the amount, in the source currency. Your wallet is debitedsourceAmount + fee.amount.
In the sample: ₦50,000.00 is sent, the fee is ₦250.00, your wallet is debited ₦50,250.00, and the recipient gets GH₵465.00.
Use the quote
PassquoteId to POST /v1/payouts or POST /v1/conversions, with the same currencies and amount.
A quote can be used once. After a payout or conversion consumes it, a second use returns 409 quote_already_consumed.
How long a quote holds
Five minutes by default.expiresAt is the authority. Read it instead of assuming.
After expiresAt, using the quote returns 422 quote_expired. Create a new quote and show the new numbers to your user before you send.
Sending without a quote
You can omitquoteId on a payout or conversion. Payve then prices it at the rate in force at that moment. Use a quote whenever a person needs to see the numbers first.
Look up quotes
When it fails
GET /v1/rates returns indicative rates without a key. See Coverage.
