Developer API

Vend data, airtime and bills from your own product

A wallet based REST API with idempotent references and a webhook for every status change. Sandbox keys are issued the moment you sign up, with no sales call and no minimum volume.

Get your keys

Call an endpoint

Every vend is a POST with a reference you generate. Repeat calls with the same reference never double vend.

Handle the webhook

We POST the final status to your URL, signed. Trust the webhook, not the initial response.

Endpoints

GET/v1/plans

Every sellable plan at your account's own tier price. Free, rate limited only.

GET/v1/wallet

Current balance, held amount and available balance, in kobo.

POST/v1/data/purchase

Vend a data bundle. Body: product_key, recipient, fields (network-specific values), reference.

POST/v1/airtime/purchase

Vend airtime. Same body shape as data, plus amount_kobo.

POST/v1/bills/validate

Confirm a cable smartcard or electricity meter and get the account name back, before you pay. Free.

POST/v1/bills/pay

Pay a cable subscription or electricity bill. Same body shape as data/airtime purchase.

GET/v1/transactions/{reference}

Look up any transaction by the reference you generated for it.

POST/v1/webhooks

GET/v1/webhooks

List your registered webhook endpoints.

DELETE/v1/webhooks/{id}

Remove a webhook endpoint.

Things that will save you a bad night

Every amount is an integer number of kobo, in requests and responses alike - never a decimal string, never naira.
Every error is HTTP status codes that mean what they say (401, 403, 404, 422, 429...) plus the same { "error": { "code", "message" } } shape on every endpoint. If a call fails, you never have to guess from a 200 response body.
One auth scheme, every call: Authorization: Bearer <your key>. Nothing changes between a GET and a POST.
Generate the reference yourself and reuse it on retry. A repeated reference returns the original result rather than vending twice.
Never treat a timeout as a failure. Poll the transaction endpoint or wait for the webhook before deciding.
Verify the webhook signature. An unsigned callback is not from us.
Rate limit is 20 requests per second per key, bursting to 50. Ask if you need more.
Sandbox mirrors live exactly, including failure modes - the same deterministic test numbers are documented on one page, so you can rehearse every path, including the reversal path, before you launch.

Stop overpaying for data.

Create your account in under a minute. No card required, no minimum funding, and you keep whatever you do not spend.

Create free account Talk to sales