Buy airtime
POST/api/v1/airtime
Send airtime to a phone number. amount is in whole naira (e.g. 100 for ₦100); everything else in the response is in kobo.
As with data, clientReference makes the purchase idempotent.
Request
Responses
- 200
- 401
- 403
- 409
- 422
The purchase was accepted.
Missing or invalid API key.
This service is not enabled for your account (e.g. airtime is disabled), or the plan is not in your catalog.
The clientReference was already used for a different order (a different plan, recipient, or amount). We reject the reuse instead of replaying the unrelated original — no purchase is made and your wallet is not debited. Use a unique clientReference per order; a genuine retry with the same parameters returns the original transaction (see Idempotency).
The request body failed validation, or your wallet has insufficient funds.