Onramp

Collect fiat and deliver stablecoins to a destination wallet.

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

Onramp converts an NGN payment into stablecoin delivered to a wallet address. The response contains the fiat payment account, quoted destination amount, expiry, and status needed to guide the payer and reconcile delivery.

Recommended flow

Choose the fiat currency, network, asset, amount, and destination address.
Create the onramp using a unique business reference.
Display the exact NGN amount and returned payment account.
Stop using the instructions after expiry.
Follow the status until stablecoin delivery is successful or failed.

Onramp

POST /v1/stablecoin/onramp

Body:

{
  "reference": "order_001",
  "fiat_currency": "NGN",
  "amount": 1000,
  "asset": "USDC",
  "chain": "SOLANA",
  "address": "OPTIONAL_SOLANA_WALLET_ADDRESS"
}

Notes:

onramp is the primary managed collection rail
if address is omitted, the business default stablecoin address is used or created
current supported public path is Solana USDC only
your submitted reference is kept as the business reference throughout the flow
create/fetch/status responses expose payment_account so the payer gets the NGN bank details to fund the onramp

Query / status:

GET /v1/stablecoin/onramp
GET /v1/stablecoin/onramp/status
GET /v1/stablecoin/onramp/rate