Skip to main content
The meCash Quote API returns a guaranteed exchange rate, fee breakdown, and settlement summary before you send money. Presenting this data to your users builds trust and prevents surprises when they confirm a payout.
Every quote response contains a quoteId. You must send the same ID when creating a payout so the locked-in rate, fees, and rules are applied.

​
Quote lifecycle

When customers request a conversion, your platform should create a quote immediately. The flow below shows how the hand-off between your systems and meCash works.
1
User requests a rate
2
Collect the source amount, currency pair, and payment channel in your UI.
3
Platform creates the quote
4
Send the data to POST /v1/quote. meCash evaluates limits, fees, and returns a quoteId.
5
User confirms
6
Store the quote and prompt the user to continue to payout before it expires (expiresInSeconds).

​
What the response contains

  • Totals: Exchange rate, fee breakdown, and target currency amount.
  • Rules: Corridor limits and compliance requirements that applied.
  • Expiry: expiresInSeconds tells you how long the quote remains valid. Quotes expire 10 minutes after creation unless otherwise stated in the response.
If the quote expires or fails validation, the payout endpoint returns an error. Refresh the quote and retry the payout with the new quoteId.

​
Why quotes matter

  • Transparency: Show the exact amount the recipient will receive before you debit the sender.
  • Compliance: Respect corridor-specific rules, limits, and required disclosures.
  • User experience: Prevent failed payouts by validating balances and rates upfront.

​
Next steps

  • Jump straight into the API Reference to inspect request and response schemas.

Create Quote API

Review the full OpenAPI reference for POST /v1/quote, including schema details, example requests, and live testing.

Get Quote API

Fetch stored quotes via the API Reference entry for GET /v1/quote/{quoteId} and validate payload structures.