Permissions - cNGN API Documentation

Some endpoints require your merchant account’s role to hold a specific permission. Permissions are managed by your organisation’s administrator in the merchant dashboard. If your role lacks the required permission, the API responds with:

{
  "status": false,
  "message": "Permission denied"
}

Permission map

Permission	Required by
Fiat Deposit	Get Virtual Account, Create Temporary Virtual Account
Redeem	Redeem Asset
Send Crypto	Withdraw
Swap	Bridge Quote, Bridge

All other endpoints only require a valid API key and whitelisted IP.

Service availability

Redemption and withdrawal endpoints are additionally subject to platform-level service controls. If a service has been temporarily disabled (for example during an incident), requests fail with:

{
  "status": 400,
  "message": "Service is currently unavailable. Please try again later."
}

This is transient; retry later or check the status page.