Skip to main content

FX and quotes

CashXChain uses quote-driven FX to make conversion costs transparent before a payment is submitted.

A quote is a temporary offer that describes how much will be debited, how much the beneficiary is expected to receive, what fees apply, which route assumptions are used, and when the quote expires.

Why quotes matter​

Cross-border payments — especially in B2B contexts — often fail operationally because the sender does not know the final recipient amount, total fees, or FX spread until after execution. CashXChain solves this by making quote acceptance explicit.

Quote components​

A quote can include:

  • Source currency and amount.
  • Target currency and estimated amount.
  • FX rate.
  • FX spread.
  • CashXChain fee.
  • Partner or payout fee estimate.
  • Quote expiry timestamp.
  • Route type.
  • Expected settlement window.
  • Required compliance fields.

Example quote request​

curl -X POST https://api.sandbox.cashxchain.com/v1/fx/quotes \
  -H "Authorization: Bearer $CXC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source_currency": "EUR",
    "target_currency": "USD",
    "source_amount": "100000.00",
    "beneficiary_country": "US",
    "payment_method": "bank_transfer"
  }'

Quote expiry​

Quotes expire because FX rates, liquidity, partner fees, and route availability change. Your integration should either submit the payment before expiry or request a new quote.

Guaranteed and indicative quotes​

Some quotes can be locked for a short time. Others are indicative, especially when a route depends on partner availability, local payout requirements, or compliance checks.

The API indicates whether a quote is guaranteed, indicative, or subject_to_review.

Conversion execution​

A payment can reference a quote. If the quote is valid and compatible with the payment instruction, CashXChain will use the quote assumptions to prepare the route. If the quote expired, the API returns an error and requires a new quote.

Slippage and route changes​

If a payment cannot be executed under the accepted quote assumptions, CashXChain may:

  • Require a new quote.
  • Move the payment to requires_action.
  • Route through an alternative partner with equivalent or better economics.
  • Fail safely before execution if customer confirmation is required.

Best practices​

  • Display quote expiry clearly to users.
  • Store the quote_id with your invoice or payment record.
  • Use webhooks to track if a payment requires a new quote.
  • Do not assume a quote is final unless the quote response says it is guaranteed.