📱

Bill Payment

Purchase airtime and data bundles for your customers. Top up mobile accounts, check data bundle availability, browse offers from multiple operators, and track all transactions through a unified API.

📡 Multiple operators💡 Instant top-up📊 Usage tracking

Airtime & Data Journey

1

🔍 Browse operators and plans

Call List Operators to view all available mobile network operators and List Data Bundles to check current offers, pricing, and validity periods for each operator.

2

📱 Select product and enter details

Choose airtime amount or data bundle from the available options, provide the recipient's phone number, and specify the operator to initiate the purchase.

3

✅ Process payment

Submit the purchase request and process payment through the integrated payment system. Receive instant confirmation with transaction reference and expected delivery time.

4

📊 Track and manage

Monitor transaction status in real-time, view purchase history, set up recurring top-ups for frequent users, and handle refunds for failed transactions.

Important Notes

Phone number validation

Always validate phone numbers against the operator's format before submitting purchase requests. Incorrect numbers will result in failed transactions and may not be eligible for refunds.

Delivery times

Airtime top-ups are typically delivered within 30 seconds. Data bundles may take up to 2 minutes depending on the operator's system availability.

Bearer token required

All endpoints require a valid Bearer token. Obtain one from the Access Token endpoint and pass it as Authorization: Bearer <token>.

Endpoints

Airtime

GET

Airtime Providers

Retrieves all available airtime providers and their details. Includes provider codes, supported countries, and minimum/maximum top-up amounts.

POST

Purchase Airtime

Processes an airtime top-up request. Requires phone number, provider code, and amount. Returns transaction ID and delivery status.

Data

GET

Data Bundles Providers

Retrieves all available data bundle providers and their details. Includes provider codes and supported countries.

GET

Provider Data Bundles

Retrieves available data bundles for a specific provider. Includes bundle codes, prices, data volumes, and validity periods.

POST

Purchase Data

Processes a data bundle purchase request. Requires phone number, provider code, and bundle code. Returns transaction ID and delivery status.

Transaction Status

POST

Transaction Status

Checks the status of a previous transaction. Requires transaction ID. Returns current status, delivery confirmation, and any error details.