Developers

Sell airtime and data from your app

One REST API for airtime, data, electricity, cable and exam pins across every Nigerian network. Credentials are issued through our API platform, Master OX.

What you get

Built for money-moving traffic

Airtime & data

All four networks. Plans priced for your tier, delivered instantly, with automatic refunds when a provider fails.

Signed requests

Reads take a bearer key. Anything that spends money is HMAC-signed, so your secret never crosses the wire and a captured request cannot be replayed.

Idempotency built in

Every purchase takes an idempotency key. A timed-out retry returns the original result instead of charging twice.

Receipts & reconciliation

A PDF receipt per transaction, and a background sweep that resolves anything left hanging by a provider timeout.

Quickstart

From nothing to a first call

1

Create an account at Master OX

Sign up at masterox.net to get your developer credentials โ€” a public key ID and a secret shown once.

2

Verify and fund

Add your BVN or NIN to raise your daily ceiling, then fund the wallet your API calls will draw from.

3

Call the API

Start with GET /api/v1/balance using a bearer key, then move to signed requests for purchases.

Check your balance

Buy airtime

Purchases are signed. The signature covers the timestamp, a one-time nonce, the method, the path and a digest of the body โ€” so nothing in flight can alter the amount.

Signing snippets for PHP and Python are in the full reference.

Endpoints

The whole surface

EndpointDoesAuth
GET /api/v1/balanceWallet balance and your current limitsBearer
GET /api/v1/plansData bundles for a networkBearer
GET /api/v1/transactions/:refStatus of one purchaseBearer
POST /api/v1/airtimeBuy airtimeSigned
POST /api/v1/dataBuy a data bundleSigned
Master OX

Credentials live at masterox.net

Master OX is our API platform โ€” sign up there for keys, usage and billing across everything we run, this API included.