Offramp

Accept stablecoins and settle out to a bank account.

Base URL: /v1/stablecoin/offramp
Auth: Authorization: Bearer <secret_key>

Offramp converts a stablecoin deposit into an NGN payout to a verified bank account. Request a quote before creation when the customer needs to see the crypto amount, rate, and expected fiat outcome.

Recommended flow

  1. Fetch the current rate or quote.
  2. Verify the bank beneficiary details.
  3. Create the offramp using a unique business reference.
  4. Display the exact crypto amount, asset, network, deposit address, and expiry.
  5. Follow status until the bank payout is successful or the flow fails.

Offramp

POST /v1/stablecoin/offramp

Body:

{
  "reference": "offramp_001",
  "fiat_currency": "NGN",
  "amount": 1000,
  "asset": "USDC",
  "chain": "SOLANA",
  "bank_code": "090286",
  "account_number": "0110000000",
  "account_name": "OPTIONAL_ACCOUNT_NAME"
}

Notes:

  • offramp is the primary managed payout rail
  • current supported public path is Solana USDC only
  • amount is the target fiat payout amount
  • account_name is optional; beneficiary lookup is attempted using bank_code and account_number
  • your submitted reference is kept as the business reference throughout the flow
  • offramp rejects requests whose quoted crypto side is below 1 stablecoin unit
  • minimum enforcement uses the quoted stablecoin amount

Query / quote / status:

  • GET /v1/stablecoin/offramp
  • GET /v1/stablecoin/offramp/status
  • GET /v1/stablecoin/offramp/rate
  • POST /v1/stablecoin/offramp/quote