Quotes Overview

Quotes are the pricing layer behind conversion and payout flows. They lock rates, fees, and transaction terms before a transaction is created.

What A Quote Does

A quote gives you a priced offer for a specific transaction intent. It typically includes:

  • source and target currencies
  • quoted amounts
  • fees
  • exchange rate
  • an expiry window

Once accepted, the quote creates or advances the transaction that the customer or business intends to perform.

When Quotes Are Used

Quotes are commonly used for flows where pricing must be agreed before execution:

  • WITHDRAWAL
  • EXCHANGE
  • SWAP
  • TRANSFER
  • DIRECT_EXCHANGE

These flows usually require you to:

  1. create the quote
  2. review the returned pricing and terms
  3. accept the quote before it expires
  4. continue processing the resulting transaction

When Quotes May Not Be Required

Not every money movement starts with an explicit quote request.

Examples:

  • deposits into assigned virtual accounts can be processed automatically when funds arrive
  • some webhook-driven deposit flows create the internal quote and transaction on the platform side

The important distinction is:

  • some flows are quote-first
  • some flows are funds-first, with quote creation handled internally by the platform

Quote Lifecycle

The typical quote lifecycle looks like this:

  1. CREATED The quote exists and can be accepted before expiry.
  2. AWAITING_PAYMENT or AWAITING_DEPOSIT The quote has been accepted and the platform is waiting for funds or confirmation.
  3. PAYMENT_CONFIRMED or DEPOSIT_CONFIRMED Funds have been received or confirmed.
  4. PROCESSING_PAYOUT The payout or conversion leg is being executed.
  5. Final state COMPLETED, EXPIRED, or FAILED

The exact intermediate states depend on corridor and payment method.

Typical Integration Pattern

For quote-first flows, the high-level pattern is:

  1. authenticate your request
  2. identify the acting user with on_behalf_of
  3. provide a unique origin_reference
  4. create the quote
  5. accept the quote
  6. track the resulting transaction through webhooks or follow-up reads

In some corridors, quote acceptance can also return payment instructions.

Important Inputs

Most quote creation flows rely on a few core fields:

  • origin_reference Your unique business reference for idempotency and reconciliation
  • on_behalf_of Identifies whether the quote is for your own business account or a linked customer
  • quote_type Defines the transaction intent
  • source_currency
  • target_currency
  • source_amount

Depending on the quote type, you may also need:

  • beneficiary_id
  • user_tag
  • corridor-specific fields such as bank_code or phone_number

Stablecoin-Involved Quotes

Quotes can also power stablecoin-funded or stablecoin-settled flows. In those cases, the quote still serves the same purpose:

  • lock pricing
  • define the transaction path
  • return the correct execution details for that corridor

Supported assets and network behavior can vary by environment and flow, so prefer values returned by the API over hardcoded assumptions.

What This Page Is Not

This page is an overview, not the full endpoint reference.

Use related pages for:

  • quote creation and acceptance behavior
  • exact request and response contracts
  • required fields by quote type
  • beneficiary creation
  • exchange rate preview behavior
  • webhook/status tracking

Related Pages