Developers · Quotes

Quotes

Lock a transparent exchange rate and fee before you move money. A quote turns into a payment by passing its quoteId to the payment call.

Request a quote

curl https://sandbox.amnenpay.com/v1/quotes \
  -X POST \
  -H "Authorization: Bearer sk_test_51H8xExampleSandboxKeyOnly" \
  -H "Idempotency-Key: idmp_quote_7c9e6679742548" \
  -H "Content-Type: application/json" \
  -d '{
    "sourceCurrency": "ETB",
    "targetCurrency": "KES",
    "sourceAmount": 5000
  }'

Quote fields

FieldDescription
sourceCurrencyCurrency you are sending from (e.g. ETB).
targetCurrencyCurrency the recipient receives (e.g. KES).
sourceAmountAmount to debit, in the source currency.
rateLocked FX rate for this quote.
feeTotal fees applied to the transfer.
targetAmountAmount the recipient will receive.
expiresAtWhen the locked rate expires and the quote must be refreshed.

Using a quote

Pass the returned quoteId to POST /payments before expiresAt. If the quote has expired, request a fresh one — rates are never silently changed on an in-flight payment.