Skip to main content
The meCash Ramp API lets you move value across the crypto–fiat boundary programmatically. There are two transaction categories:
  • Crypto-to-Crypto — transfer a supported token (USDC, USDT, ETH) from your meCash wallet to any external blockchain address.
  • Offramp (Crypto-to-Fiat) — convert crypto to a fiat currency (NGN, USD, EUR, GBP, CAD) and deliver it via bank transfer or mobile money.
Both flows share the same API shape: create a quote → execute a transaction → receive a webhook.

​
Ramp API lifecycle

​
Crypto-to-Crypto

​
Offramp (Crypto-to-Fiat)

Subscribe to ramp webhooks to receive reliable transaction outcome notifications. See the Ramp Webhook Events for payload details.

​
Operational considerations

  • Quotes expire: Ramp quotes are valid for a limited window (~5–10 minutes). Always create a new quote if the previous one has expired before you call /order.
  • Gas fees are mandatory: Crypto-to-crypto transfers require gas. Use the Get Gas Fee endpoint to present accurate fee options (LOW / MEDIUM / HIGH) to your users before quoting.
  • Offramp gas is included in the quote: When you call Create Quote (Offramp), the gasFee object is returned alongside the quote — no separate gas lookup is needed.
  • Check rules before executing: The rules array on every quote response enforces per-corridor minimum and maximum limits. Validate these in your UI before allowing users to proceed.
  • Webhooks are the source of truth: The /order response gives you an initial PENDING state. Treat it as an acknowledgement only. Final COMPLETED or FAILED status arrives asynchronously via webhook.
  • Fetch wallet balance first: Use Get Wallet Balance to confirm sufficient funds before creating a quote, especially for crypto-to-crypto transfers where gas is additive.

​
Transaction states

StateDescription
PENDINGOrder accepted and queued for processing
PROCESSINGTransaction has been broadcast on-chain (crypto) or sent for bank settlement (offramp)
COMPLETEDFunds successfully delivered to the recipient
FAILEDTransaction failed — check the webhook payload for details

​
Ramp API routes

Get Wallet Balance

Check available and pending token balances before initiating a transfer.

Get Gas Fee

Estimate LOW / MEDIUM / HIGH gas fees for a crypto-to-crypto transfer.

Create Quote (Crypto)

Generate a quote for a crypto-to-crypto transfer with rate and fee breakdown.

Create Quote (Offramp)

Generate a quote to convert crypto to fiat currency.

Get Quote (Crypto)

Retrieve details of a previously created crypto-to-crypto quote by ID.

Get Quote (Offramp)

Retrieve details of a previously created offramp quote by ID.

Create Transaction

Execute a crypto or offramp transaction using a valid quoteId.

Get Transaction

Fetch the full details and current state of a Ramp transaction.

​
Next steps