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.