Overview

ClovaPay Africa

ClovaPay Africa is a crypto-to-fiat offramp API. You send stablecoins — we deliver Nigerian Naira to any bank account automatically.

The API is built for developers and AI agents. Every protected endpoint is gated via the x402 protocol (Thirdweb), meaning your agent can discover the price, attach a micropayment proof, and call the API — with no dashboard signup or manual key rotation. Internal/admin calls use the OWNER_API_KEY header bypass.

Offramp stablecoins

Get a quote, create an order, send crypto to the deposit address. Naira hits the bank account automatically once the deposit is confirmed on-chain.

Quickstart guide →

How an offramp works

  1. 1
    POST /v1/quotes

    Pass the asset (cUSD_CELO, USDC_BASE, or USDCX_STACKS), amount, and destination currency (NGN). Get back the exchange rate, fee breakdown, and a quote that's valid for 5 minutes.

  2. 2
    POST /v1/orders

    Submit recipient bank details (account number, bank code, account name). We create a Paycrest order and return a deposit address unique to this transaction.

  3. 3
    Send crypto to depositAddress

    Transfer exactly the quoted amount to the returned deposit address. Our on-chain verifier checks the transaction on Celo, Base, or Stacks.

  4. 4
    NGN lands in bank account

    Once confirmed, Paycrest processes the NGN transfer. A webhook fires to POST /v1/webhooks/paycrest when the order is fulfilled or fails.

Supported assets (Phase 1)

Asset keyTokenNetworkDeposit mechanism
cUSD_CELOcUSDCeloPaycrest deposit address
USDC_BASEUSDCBasePaycrest deposit address
USDCX_STACKSUSDCxStacksClarity contract (clova-deposit.clar), include orderId as memo

Fee structure

  • • FX spread: 3% margin over market rate (locked into the quote)
  • • Platform fee: 150 bps (1.5%) applied to the gross NGN amount
  • • Both fees are visible in every /v1/quotes response before you commit

Order expiry

Orders expire after 30 minutes with no deposit. Expired orders are automatically marked expired by the background expiry worker. Rates are locked for 5 minutes from the time of quoting.