Developer docs
Amounts & currency
How to write amounts, and what currency we support.
Kobo, not naira
Every amount in the API is an integer number of kobo. ₦1 = 100 kobo. Never send decimals — 2500.50 is rejected.
- ₦500 →
50000 - ₦2,500 →
250000 - ₦1,000,000 →
100000000
Amounts come back in kobo too, with a _kobo suffix so there is never any doubt (amount_kobo, collection_fee_kobo, net_kobo).
Currency
NGN only. currency defaults to "NGN"; passing anything else is rejected. We are building the Nigeria rail first — USD, EUR and cross-border are not supported today.
Limits
The endpoint accepts amounts up to ₦10,000,000. Your plan's per-transaction ceiling applies on top of that:
- Starter — ₦200,000 per transaction
- Growth — ₦1,000,000
- Business — ₦5,000,000
- Merchant Growth — ₦50,000,000
- Merchant Enterprise — uncapped (agreed in your contract)
Escrow products have a minimum of ₦10,000. Direct collections have no minimum.