Preview Quotations

Stateless pricing preview across every corridor enabled on your account. Converts amount in currency to USD, then returns a quotation for each currency in your account supported_currencies.

Use this instead of decodeQr + getQuotation when you only need a rate. It creates no transaction, so it will not appear in listTransactions and nothing expires against your account. One call covers every corridor you have enabled.

Authentication

• REQUIRED: Basic Auth Authorization: Basic base64(client_id:client_secret).

Request validation (order)

• amount (number, required): must be > 0, else 400 INVALID_AMOUNT.

• currency (string, required): ISO 4217, case-insensitive, else 400 MISSING_REQUIRED_FIELD.

• 401 AUTHENTICATION_REQUIRED if authentication fails.

• 429 RATE_LIMIT_EXCEEDED when the per-app rate limit is hit.

• 400 INVALID_CURRENCY when no exchange rate is available for currency.

Behaviour

• Target currencies come from your account supported_currencies (falls back to USD when none are configured).

• A target currency is omitted from the response when it has no available FX rate, or when the converted local amount falls outside that corridor’s min/max limits.

• Responses are cached briefly; expires_at is always refreshed to 30 minutes from the time of the response.

Response (200 JSON)

• quotations: array of per-corridor items, each with amount and currency (local), exchange_rate, amount_usd, fee, percentage_fee, fixed_fee, expires_at.

• Formatting matches the other pricing endpoints: exchange_rate at 10 decimal places, USD fields at 2.

Note: these figures are indicative. Binding pricing for a specific payout still comes from getQuotation on a real transaction.