Partner API · v1
Sell data, airtime and bills from your own platform
Connect your website, app or bot to MsjPay. Every purchase is one HTTPS request with a JSON body, paid from your MsjPay wallet at your reseller price, and you get the result instantly or by webhook.
Content-Type: application/json) and JSON responsesQuick start
- Log in and open Developer API. Generate a live key (and a sandbox key for testing).
- Call GET /catalog to get plan IDs and your prices.
- Buy with e.g. POST /data, sending your key, the plan ID, the phone number and your transaction PIN.
- Set a webhook URL so you're told when pending orders finish.
Connect without coding
Already run a VTU website? You don't need to write any code to sell our services. Add MsjPay as a supplier in your own admin panel, exactly like any other supplier — our API speaks the two most common VTU script formats.
YOUR_API_KEY:YOUR_PIN (key, colon, transaction PIN).| Service | Vicom-type URL | MSORG-type URL |
|---|---|---|
| Balance | GET /api/user | GET /api/user/ |
| Airtime | POST /api/airtime | POST /api/topup/ |
| Data | POST /api/data | POST /api/data/ |
| Cable TV | POST /api/cable verify: /api/cable/cable-validation | POST /api/cablesub/ verify: /api/validateiuc |
| Electricity | POST /api/bill verify: /api/bill/bill-validation | POST /api/billpayment/ verify: /api/validatemeter |
| Exam PINs | POST /api/exam | POST /api/epin/ |
| Recharge / data cards | POST /api/recharge_card POST /api/data_card | same |
| Bulk SMS | POST /api/bulk-sms | same |
| Order status | GET /api/transaction/<request-id> | same |
| Plan lists | GET /api/data_plans · /api/get-cable · /api/get-cable-plan?cable=ID · /api/get-bill · /api/get-exam · /api/get-networks | |
- Network numbers follow your script's format. Vicom-type:
1MTN,2AIRTEL,3GLO,49MOBILE. MSORG-type:1MTN,2GLO,3AIRTEL,49MOBILE. Network names ("MTN") work too. - Common field spellings are all accepted (
phoneormobile_number,planordata_plan,iucorsmart_card_number, …), and replies include both formats' fields (status,Status,api_response,msg,request-id,new_balance…). - Send your
request-id(most scripts do) and retries are safe: the same ID returns the original order. Your script's automatic status check (/api/transaction/<request-id>) works too. - Adex websites: add us under Adex API. Website URL:
https://msjpay.ng(no/apiat the end). Username: your username here. Password: your password here, or your API key, followed by a colon and your transaction PIN (yourpassword:1234). If your API key is locked to your server IPs, leave out the colon and PIN. Then map each plan to our IDs from the tables below, and set your Adex IDs for networks to the Vicom numbers above. - Building something new? Use the v1 API below — it is cleaner and fully documented here.
Authentication
Send your API key as a Bearer token on every request:
Authorization: Bearer YOUR_API_KEY
- Live keys look like
msj_live_…and spend real money. Sandbox keys start withsandbox_and are fully simulated (details). Same URL — the key decides. - Purchases need your transaction PIN in the body (
"pin") — unless your key is locked to your server's IP addresses. Three wrong PINs lock purchases for 10 minutes. - IP allowlist (recommended): on the Developer API page, list your server's IP addresses. Requests from any other IP are refused, and purchases from your listed IPs no longer need the PIN — the simplest and safest setup for a server-to-server integration.
- Keys don't expire. If one leaks, regenerate it on the Developer API page — the old key stops working at once.
Responses & errors
Every response has a status field. A purchase ends in one of four ways — handle all four:
{
"status": "success",
"message": "Data purchase successful",
"data": {
"reference": "MSJE213826EA8181791581826",
"balance_after": 44770
}
}
Delivered. Keep the reference.
{
"status": "pending",
"success": true,
"pending": true,
"message": "Your order is processing.",
"data": {
"reference": "MSJE213826EA8181791581826"
}
}
Accepted and charged; the provider hasn't confirmed yet. Wait for the webhook or poll /receipt. Do not retry.
{
"status": "error",
"success": false,
"message": "Transaction failed. Your wallet has been refunded.",
"refunded": true,
"reference": "MSJE213826EA8181791581826"
}
The provider declined it and your wallet was refunded. Safe to retry.
{
"status": "error",
"message": "Invalid transaction PIN"
}
Nothing was charged. Fix the request and try again.
| HTTP | Meaning |
|---|---|
| 200 | Success or pending (check status). |
| 400 | Missing/invalid field, wrong PIN, insufficient balance ("Insufficient balance. Please top up your wallet."), or declined and refunded. |
| 401 | Missing, wrong or revoked API key, or suspended account. |
| 403 | "API access requires a vendor account.", API access disabled for the account, request from an IP not on your allowlist, or the service is switched off. |
| 404 | Unknown transaction reference (/receipt). |
| 405 | Wrong method (e.g. GET on a POST endpoint). |
| 429 | Too many requests — slow down (limits). |
| 500 | Our error. Check /receipt before retrying a purchase. |
Limits & safety
- Purchases: 30 per minute per account. Smartcard/meter lookups: 20 per 5 minutes. Bulk SMS: 20 requests per hour.
- Duplicate protection: an identical purchase (same service, number and amount/plan) within 5 seconds is refused with "Duplicate request detected" and not charged.
- Retrying safely: send your own
request_idwith each purchase. If a request times out, send it again with the same ID — you get the original order back ("duplicate": true) instead of buying twice. Without a request_id, check /transactions before retrying. - Your account's daily spending limits and per-purchase limits also apply.
Sandbox testing
- Use your
sandbox_…key against the same base URL. Nothing real is bought and your live wallet is untouched. - Your sandbox wallet starts with ₦1,000,000 (reset it any time on the Developer API page).
- Purchases succeed instantly — unless the phone, meter or smartcard number ends in
0000, which simulates a decline and refund so you can test that path. - Sandbox purchases also send webhooks, marked
"sandbox": true.
Wallet balance
Your wallet and cashback balance. With a sandbox key it returns the simulated sandbox balance.
curl "https://msjpay.ng/api/v1/balance" \
-H "Authorization: Bearer YOUR_API_KEY"
<?php
$ch = curl_init("https://msjpay.ng/api/v1/balance");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/balance", {
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
const data = await res.json();
console.log(data);
import requests
res = requests.get(
"https://msjpay.ng/api/v1/balance",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=60,
)
print(res.json())
{
"status": "success",
"data": {
"wallet_balance": 45250,
"cashback_balance": 120.5,
"currency": "NGN",
"sandbox": false
}
}
Catalog & your prices
Every active data plan, cable plan, electricity company and exam type, priced for your account tier. Call it to build your own price list, and cache it — prices change rarely.
Use data_plans[].id as plan_id when buying data, cable_plans[].id as plan_id for cable TV, cable_plans[].cable_id when validating a smartcard, and discos[].disco_id for electricity. limits are the per-purchase amount limits for airtime and electricity.
curl "https://msjpay.ng/api/v1/catalog" \
-H "Authorization: Bearer YOUR_API_KEY"
<?php
$ch = curl_init("https://msjpay.ng/api/v1/catalog");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/catalog", {
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
const data = await res.json();
console.log(data);
import requests
res = requests.get(
"https://msjpay.ng/api/v1/catalog",
headers={"Authorization": "Bearer YOUR_API_KEY"},
timeout=60,
)
print(res.json())
{
"status": "success",
"data": {
"data_plans": [
{
"id": 209,
"network": "GLO",
"plan_name": "1 GB",
"display_name": "1GB",
"data_type": "SME",
"data_size": "1GB",
"validity": "14 Days",
"selling_price": "480.00",
"network_id": 2
}
],
"cable_plans": [
{
"id": 12,
"provider": "GOTV",
"cable_id": "1",
"plan_name": "GOtv Max",
"display_name": "GOtv Max",
"selling_price": "8500.00"
}
],
"discos": [
{
"disco_id": 1,
"disco_name": "Ikeja Electric",
"charge": "0.00",
"postpaid_charge": "0.00"
}
],
"exam_prices": {
"WAEC": 3500,
"NECO": 1200
},
"limits": {
"airtime_min": 50,
"airtime_max": 10000,
"electricity_min": 1000,
"electricity_max": 50000
},
"recharge_card_prices": {
"MTN": {
"100": 98
}
},
"bulk_sms_pricing": {
"price_per_page": 3,
"discount_percent": 0
}
}
}
Buy data
Sends a data bundle to a phone number.
| Body field | Type | Required | Description |
|---|---|---|---|
| plan_id | integer | Yes | The plan's id from GET /catalog or the data plan table. |
| phone | string | Yes | 11-digit Nigerian number, e.g. 08031234567. |
| pin | string | Yes | The account's 4–6 digit transaction PIN (the one set on the website or app). Three wrong PINs lock purchases for 10 minutes. Not needed if your key is locked to your server IPs (details). |
| request_id | string | No | Your own unique order ID (max 64 characters). Send the same ID again — e.g. after a timeout — and you get the original order back (with "duplicate": true) instead of a second purchase. |
| network | string | No | Ignored — the plan decides the network. Accepted for older integrations. |
| ported | boolean | No | Send true for a number ported to another network, to skip the number-prefix check. |
curl -X POST "https://msjpay.ng/api/v1/data" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"plan_id":209,"phone":"08157038870","pin":"12345","request_id":"order-1002"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/data");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'plan_id' => 209,
'phone' => '08157038870',
'pin' => '12345',
'request_id' => 'order-1002',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/data", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"plan_id": 209,
"phone": "08157038870",
"pin": "12345",
"request_id": "order-1002"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/data",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"plan_id":209,"phone":"08157038870","pin":"12345","request_id":"order-1002"},
timeout=60,
)
print(res.json())
{
"status": "success",
"message": "Data purchase successful",
"data": {
"reference": "MSJE213826EA8181791581826",
"cashback_earned": 0,
"balance_before": 45250,
"balance_after": 44770
}
}
{
"status": "error",
"message": "This number looks like an MTN line, not GLO. If it was ported, set ported to true."
}
Buy airtime
Tops up a phone number. Your discount is applied automatically, so you are charged less than the face value.
| Body field | Type | Required | Description |
|---|---|---|---|
| network | string | Yes | MTN, GLO, AIRTEL or 9MOBILE. |
| phone | string | Yes | 11-digit Nigerian number. |
| amount | number | Yes | Face value in naira. Default limits ₦50 – ₦10,000 per purchase. |
| pin | string | Yes | The account's 4–6 digit transaction PIN (the one set on the website or app). Three wrong PINs lock purchases for 10 minutes. Not needed if your key is locked to your server IPs (details). |
| ported | boolean | No | Send true for a number ported to another network, to skip the number-prefix check. |
| request_id | string | No | Your own unique order ID (max 64 characters). Send the same ID again — e.g. after a timeout — and you get the original order back (with "duplicate": true) instead of a second purchase. |
curl -X POST "https://msjpay.ng/api/v1/airtime" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"network":"MTN","phone":"08031234567","amount":100,"pin":"12345","request_id":"order-1001"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/airtime");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'network' => 'MTN',
'phone' => '08031234567',
'amount' => 100,
'pin' => '12345',
'request_id' => 'order-1001',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/airtime", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"network": "MTN",
"phone": "08031234567",
"amount": 100,
"pin": "12345",
"request_id": "order-1001"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/airtime",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"network":"MTN","phone":"08031234567","amount":100,"pin":"12345","request_id":"order-1001"},
timeout=60,
)
print(res.json())
{
"status": "success",
"message": "Airtime purchase successful",
"data": {
"reference": "MSJE213826EA8181791581826",
"cashback_earned": 0,
"balance_before": 45250,
"balance_after": 45151
}
}
Verify a smartcard / IUC
Looks up the customer name on a DStv, GOtv or Startimes card before you charge them. Free, but limited to 20 lookups per 5 minutes.
| Body field | Type | Required | Description |
|---|---|---|---|
| cable_id | integer | Yes | The provider: cable_plans[].cable_id from the catalog (see the cable table). |
| smartcard | string | Yes | Smartcard / IUC number. |
curl -X POST "https://msjpay.ng/api/v1/validate-cable" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"cable_id":1,"smartcard":"7023456789"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/validate-cable");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'cable_id' => 1,
'smartcard' => '7023456789',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/validate-cable", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"cable_id": 1,
"smartcard": "7023456789"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/validate-cable",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"cable_id":1,"smartcard":"7023456789"},
timeout=60,
)
print(res.json())
{
"status": "success",
"success": true,
"message": "SmartCard verified successfully.",
"data": {
"name": "IBRAHIM MUSA",
"customer_name": "IBRAHIM MUSA",
"smartcard": "7023456789"
}
}
Pay for cable TV
Renews or changes a DStv, GOtv or Startimes subscription.
| Body field | Type | Required | Description |
|---|---|---|---|
| plan_id | integer | Yes | The package's id from cable_plans (catalog or cable table). The package decides the provider. |
| smartcard | string | Yes | Smartcard / IUC number. Verify it first with /validate-cable. |
| pin | string | Yes | The account's 4–6 digit transaction PIN (the one set on the website or app). Three wrong PINs lock purchases for 10 minutes. Not needed if your key is locked to your server IPs (details). |
| request_id | string | No | Your own unique order ID (max 64 characters). Send the same ID again — e.g. after a timeout — and you get the original order back (with "duplicate": true) instead of a second purchase. |
| phone | string | No | Customer's phone number, passed to the provider. |
curl -X POST "https://msjpay.ng/api/v1/cabletv" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"plan_id":12,"smartcard":"7023456789","pin":"12345"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/cabletv");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'plan_id' => 12,
'smartcard' => '7023456789',
'pin' => '12345',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/cabletv", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"plan_id": 12,
"smartcard": "7023456789",
"pin": "12345"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/cabletv",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"plan_id":12,"smartcard":"7023456789","pin":"12345"},
timeout=60,
)
print(res.json())
{
"status": "success",
"message": "Subscription successful",
"data": {
"reference": "MSJE213826EA8181791581826",
"cashback_earned": 0,
"balance_before": 45250,
"balance_after": 36750
}
}
Verify a meter
Looks up the customer name and address on a meter. Free, 20 lookups per 5 minutes.
| Body field | Type | Required | Description |
|---|---|---|---|
| disco_id | integer | Yes | The electricity company's disco_id (catalog or disco table). |
| meter_number | string | Yes | Meter number. |
| meter_type | string | Yes | prepaid or postpaid. |
curl -X POST "https://msjpay.ng/api/v1/validate-meter" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"disco_id":1,"meter_number":"45031234567","meter_type":"prepaid"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/validate-meter");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'disco_id' => 1,
'meter_number' => '45031234567',
'meter_type' => 'prepaid',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/validate-meter", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"disco_id": 1,
"meter_number": "45031234567",
"meter_type": "prepaid"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/validate-meter",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"disco_id":1,"meter_number":"45031234567","meter_type":"prepaid"},
timeout=60,
)
print(res.json())
{
"status": "success",
"data": {
"name": "ADEBAYO OLU",
"address": "12 Allen Avenue, Ikeja"
}
}
Pay an electricity bill
Buys prepaid units (returns the token) or pays a postpaid bill.
| Body field | Type | Required | Description |
|---|---|---|---|
| disco_id | integer | Yes | The electricity company's disco_id. |
| meter_number | string | Yes | Meter number. Verify it first with /validate-meter. |
| meter_type | string | Yes | prepaid or postpaid. |
| amount | number | Yes | Amount in naira. Default limits ₦1,000 – ₦50,000. A company may add a service charge (see discos[].charge). |
| pin | string | Yes | The account's 4–6 digit transaction PIN (the one set on the website or app). Three wrong PINs lock purchases for 10 minutes. Not needed if your key is locked to your server IPs (details). |
| request_id | string | No | Your own unique order ID (max 64 characters). Send the same ID again — e.g. after a timeout — and you get the original order back (with "duplicate": true) instead of a second purchase. |
| phone | string | No | Customer's phone number. |
If the provider is slow, the response has "status": "pending" and "token": null; the token arrives in your webhook and in /receipt.
curl -X POST "https://msjpay.ng/api/v1/electricity" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"disco_id":1,"meter_number":"45031234567","meter_type":"prepaid","amount":2000,"pin":"12345"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/electricity");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'disco_id' => 1,
'meter_number' => '45031234567',
'meter_type' => 'prepaid',
'amount' => 2000,
'pin' => '12345',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/electricity", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"disco_id": 1,
"meter_number": "45031234567",
"meter_type": "prepaid",
"amount": 2000,
"pin": "12345"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/electricity",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"disco_id":1,"meter_number":"45031234567","meter_type":"prepaid","amount":2000,"pin":"12345"},
timeout=60,
)
print(res.json())
{
"status": "success",
"success": true,
"message": "Electricity purchase successful",
"pending": false,
"data": {
"reference": "MSJE213826EA8181791581826",
"token": "1234-5678-9012-3456-7890",
"cashback_earned": 0,
"pending": false,
"balance_before": 45250,
"balance_after": 43250
}
}
Buy exam PINs
WAEC, NECO, NABTEB and other result-checker PINs.
| Body field | Type | Required | Description |
|---|---|---|---|
| exam_name | string | Yes | Exam code, e.g. WAEC, NECO, NABTEB (see the exam table). |
| quantity | integer | Yes | 1 – 5 PINs. |
| pin | string | Yes | The account's 4–6 digit transaction PIN (the one set on the website or app). Three wrong PINs lock purchases for 10 minutes. Not needed if your key is locked to your server IPs (details). |
| request_id | string | No | Your own unique order ID (max 64 characters). Send the same ID again — e.g. after a timeout — and you get the original order back (with "duplicate": true) instead of a second purchase. |
curl -X POST "https://msjpay.ng/api/v1/exam_pin" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"exam_name":"WAEC","quantity":1,"pin":"12345"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/exam_pin");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'exam_name' => 'WAEC',
'quantity' => 1,
'pin' => '12345',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/exam_pin", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"exam_name": "WAEC",
"quantity": 1,
"pin": "12345"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/exam_pin",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"exam_name":"WAEC","quantity":1,"pin":"12345"},
timeout=60,
)
print(res.json())
{
"status": "success",
"message": "Exam PIN purchase successful",
"data": {
"reference": "MSJE213826EA8181791581826",
"pins": [
{
"pin": "123456789012",
"serial": "WRN123456789"
}
],
"balance_before": 45250,
"balance_after": 41750
}
}
Print recharge cards
Generates airtime PINs to print or resell. GET /recharge-card returns the networks and the denominations currently available.
| Body field | Type | Required | Description |
|---|---|---|---|
| network_id | integer | Yes | 1 MTN, 2 GLO, 3 AIRTEL, 4 9MOBILE. |
| denomination | integer | Yes | Card value, e.g. 100, 200, 500 — must be one returned by GET /recharge-card. |
| quantity | integer | No | 1 – 50 cards (default 1). |
| pin | string | Yes | The account's 4–6 digit transaction PIN (the one set on the website or app). Three wrong PINs lock purchases for 10 minutes. Not needed if your key is locked to your server IPs (details). |
| request_id | string | No | Your own unique order ID (max 64 characters). Send the same ID again — e.g. after a timeout — and you get the original order back (with "duplicate": true) instead of a second purchase. |
| name_on_card | string | No | Business name printed on the cards (max 30 characters). |
curl -X POST "https://msjpay.ng/api/v1/recharge-card" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"network_id":1,"denomination":100,"quantity":2,"pin":"12345","name_on_card":"My Shop"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/recharge-card");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'network_id' => 1,
'denomination' => 100,
'quantity' => 2,
'pin' => '12345',
'name_on_card' => 'My Shop',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/recharge-card", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"network_id": 1,
"denomination": 100,
"quantity": 2,
"pin": "12345",
"name_on_card": "My Shop"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/recharge-card",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"network_id":1,"denomination":100,"quantity":2,"pin":"12345","name_on_card":"My Shop"},
timeout=60,
)
print(res.json())
{
"status": "success",
"message": "2 card(s) ready",
"data": {
"reference": "MSJE213826EA8181791581826",
"pins": [
{
"pin": "1234567890123456",
"serial": "SN0001"
},
{
"pin": "6543210987654321",
"serial": "SN0002"
}
]
}
}
Print data cards
Generates data PINs. GET /data-card?net=MTN lists the plans for a network.
| Body field | Type | Required | Description |
|---|---|---|---|
| plan_id | integer | Yes | Data plan id (same IDs as /data). |
| quantity | integer | No | 1 – 5 cards (default 1). |
| pin | string | Yes | The account's 4–6 digit transaction PIN (the one set on the website or app). Three wrong PINs lock purchases for 10 minutes. Not needed if your key is locked to your server IPs (details). |
| request_id | string | No | Your own unique order ID (max 64 characters). Send the same ID again — e.g. after a timeout — and you get the original order back (with "duplicate": true) instead of a second purchase. |
curl -X POST "https://msjpay.ng/api/v1/data-card" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"plan_id":209,"quantity":1,"pin":"12345"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/data-card");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'plan_id' => 209,
'quantity' => 1,
'pin' => '12345',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/data-card", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"plan_id": 209,
"quantity": 1,
"pin": "12345"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/data-card",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"plan_id":209,"quantity":1,"pin":"12345"},
timeout=60,
)
print(res.json())
{
"status": "success",
"message": "1 card(s) ready",
"data": {
"reference": "MSJE213826EA8181791581826",
"pins": [
{
"pin": "1234567890",
"serial": "DC0001"
}
]
}
}
Send bulk SMS
Sends one message to many numbers. Limited to 20 requests per hour.
| Body field | Type | Required | Description |
|---|---|---|---|
| sender_id | string | Yes | Sender name shown on phones, max 11 characters. |
| message | string | Yes | The message. Long messages are charged per page (see bulk_sms_pricing in the catalog). |
| recipients | array or string | Yes | Phone numbers as a JSON array, or one string separated by commas or new lines. |
| pin | string | Yes | The account's 4–6 digit transaction PIN (the one set on the website or app). Three wrong PINs lock purchases for 10 minutes. Not needed if your key is locked to your server IPs (details). |
| request_id | string | No | Your own unique order ID (max 64 characters). Send the same ID again — e.g. after a timeout — and you get the original order back (with "duplicate": true) instead of a second purchase. |
curl -X POST "https://msjpay.ng/api/v1/bulk_sms" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sender_id":"MyShop","message":"Your order is ready.","recipients":["08031234567","08051234567"],"pin":"12345"}'
<?php
$ch = curl_init("https://msjpay.ng/api/v1/bulk_sms");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode([
'sender_id' => 'MyShop',
'message' => 'Your order is ready.',
'recipients' => [
'08031234567',
'08051234567',
],
'pin' => '12345',
]),
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
'Content-Type: application/json',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/bulk_sms", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
body: JSON.stringify({
"sender_id": "MyShop",
"message": "Your order is ready.",
"recipients": [
"08031234567",
"08051234567"
],
"pin": "12345"
})
});
const data = await res.json();
console.log(data);
import requests
res = requests.post(
"https://msjpay.ng/api/v1/bulk_sms",
headers={"Authorization": "Bearer YOUR_API_KEY"},
json={"sender_id":"MyShop","message":"Your order is ready.","recipients":["08031234567","08051234567"],"pin":"12345"},
timeout=60,
)
print(res.json())
{
"status": "success",
"message": "SMS sent to 2 recipient(s)",
"data": {
"reference": "MSJE213826EA8181791581826"
}
}
Transaction status
Gets one transaction by its reference — use it to check a pending order. If an order has been pending for over 2 minutes, this call also re-checks it with the provider before answering.
| Query parameter | Type | Required | Description |
|---|---|---|---|
| reference | string | Yes | The reference you got when buying (query string). |
data.status is success, pending, processing or failed. A failed order is refunded to your wallet automatically.
curl "https://msjpay.ng/api/v1/receipt?reference=MSJE213826EA8181791581826" \
-H "Authorization: Bearer YOUR_API_KEY"
<?php
$ch = curl_init("https://msjpay.ng/api/v1/receipt?reference=MSJE213826EA8181791581826");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/receipt?reference=MSJE213826EA8181791581826", {
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
const data = await res.json();
console.log(data);
import requests
res = requests.get(
"https://msjpay.ng/api/v1/receipt",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"reference":"MSJE213826EA8181791581826"},
timeout=60,
)
print(res.json())
{
"status": "success",
"success": true,
"data": {
"id": 95,
"reference": "MSJE213826EA8181791581826",
"transaction_ref": "MSJE213826EA8181791581826",
"category": "data",
"type": "debit",
"amount": 480,
"status": "success",
"description": "GLO 1 GB for 08157038870",
"phone": "08157038870",
"balance_before": 45250,
"balance_after": 44770,
"charge": 0,
"provider_ref": null,
"created_at": "2026-10-09 22:37:06",
"pins": [],
"token": null,
"meta": {},
"recharge_card": null
}
}
{
"status": "error",
"success": false,
"message": "Transaction not found."
}
Transaction history
Your transactions, newest first.
| Query parameter | Type | Required | Description |
|---|---|---|---|
| page | integer | No | Page number (default 1). |
| per_page | integer | No | 10 – 50 (default 20). |
| filter | string | No | Only one service, e.g. data, airtime, cabletv, electricity. |
curl "https://msjpay.ng/api/v1/transactions?page=1&per_page=20&filter=data" \
-H "Authorization: Bearer YOUR_API_KEY"
<?php
$ch = curl_init("https://msjpay.ng/api/v1/transactions?page=1&per_page=20&filter=data");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer YOUR_API_KEY',
],
]);
$response = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($response);
const res = await fetch("https://msjpay.ng/api/v1/transactions?page=1&per_page=20&filter=data", {
headers: {
"Authorization": "Bearer YOUR_API_KEY"
}
});
const data = await res.json();
console.log(data);
import requests
res = requests.get(
"https://msjpay.ng/api/v1/transactions",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"page":1,"per_page":20,"filter":"data"},
timeout=60,
)
print(res.json())
{
"status": "success",
"data": {
"transactions": [
{
"id": 95,
"transaction_ref": "MSJE213826EA8181791581826",
"category": "data",
"amount": "480.00",
"status": "success",
"description": "GLO 1 GB for 08157038870",
"created_at": "2026-10-09 22:37:06"
}
],
"total": 1,
"page": 1,
"per_page": 20,
"total_pages": 1
}
}
Webhooks
Set an HTTPS URL on the Developer API page. When any of your purchases reaches a final result — success, or failed (refunded) — we POST it to you. This is how you learn the outcome of a pending order without polling.
| Header | Value |
|---|---|
| X-Webhook-Event | transaction.success or transaction.failed |
| X-Webhook-Signature | HMAC-SHA256 of the raw request body, using your live API key as the secret (your sandbox key if you have no live key), in hex. Check it before trusting the body. |
| Content-Type | application/json |
{
"event": "transaction.success",
"reference": "MSJE213826EA8181791581826",
"status": "success",
"service": "electricity",
"amount": 2000,
"description": "Ikeja Electric prepaid ₦2,000 for 45031234567",
"phone": "08031234567",
"network": null,
"refunded": false,
"balance_after": 43250,
"sandbox": false,
"created_at": "2026-10-09T22:37:06+01:00",
"timestamp": "2026-10-09T22:37:40+01:00",
"token": "1234-5678-9012-3456-7890"
}
- Reply with any 2xx status within 10 seconds. Otherwise we retry after 1, 5, 15, 60 and 240 minutes, then stop.
- You may receive the same event more than once — use
referenceto ignore repeats. - Failed orders include a
message; electricity includes thetoken. If you regenerate your live key, signatures use the new key.
Verifying the signature
<?php
$body = file_get_contents('php://input');
$expected = hash_hmac('sha256', $body, 'YOUR_LIVE_API_KEY');
if (!hash_equals($expected, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'] ?? '')) {
http_response_code(401);
exit;
}
$event = json_decode($body, true);
// Look up your order by $event['reference'] and mark it success / failed.
http_response_code(200);
const crypto = require("crypto");
const express = require("express");
const app = express();
app.post("/webhook", express.raw({ type: "application/json" }), (req, res) => {
const expected = crypto.createHmac("sha256", process.env.LIVE_API_KEY)
.update(req.body).digest("hex");
const got = req.get("X-Webhook-Signature") || "";
if (got.length !== expected.length ||
!crypto.timingSafeEqual(Buffer.from(got), Buffer.from(expected))) {
return res.sendStatus(401);
}
const event = JSON.parse(req.body);
// Look up your order by event.reference and mark it success / failed.
res.sendStatus(200);
});
import hashlib, hmac, json
from flask import Flask, request, abort
app = Flask(__name__)
@app.post("/webhook")
def webhook():
body = request.get_data()
expected = hmac.new(b"YOUR_LIVE_API_KEY", body, hashlib.sha256).hexdigest()
if not hmac.compare_digest(expected, request.headers.get("X-Webhook-Signature", "")):
abort(401)
event = json.loads(body)
# Look up your order by event["reference"] and mark it success / failed.
return "", 200
Data plan IDs
Live list of active plans. Send the ID as plan_id. Your prices are in GET /catalog.
ALPHA (8 plans)
| ID | Plan | Type | Validity |
|---|---|---|---|
| 244 | Alpha N600 - ₦600 (30days ) | alpha | 30DAY |
| 245 | Alpha N1100 - ₦1,100 (30 days) | alpha | 30DAY |
| 246 | Alpha N1600 - ₦1,600 (30 days) | alpha | 30DAY |
| 247 | Alpha N2100 - ₦2,100 (30 days) | alpha | 30DAY |
| 248 | Alpha N2600 - ₦2,600 (30 days) | alpha | 30DAY |
| 249 | Alpha N3120 - ₦3,120 (30 days) | alpha | 30DAY |
| 250 | Alpha N3620 - ₦3,620 (30 days) | alpha | 30DAY |
| 251 | Alpha N4150 - ₦4,150 (30 days) | alpha | 30DAY |
KIRANI (15 plans)
| ID | Plan | Type | Validity |
|---|---|---|---|
| 252 | 30 Minutes - ₦520 (30 days) | kirani | 30DAY |
| 253 | 50 Minutes - ₦800 (30days) | kirani | 30DAY |
| 254 | 70 Minutes - ₦1,090 (30 days) | kirani | 30DAY |
| 255 | 100 Minutes - ₦1,580 (30 days) | kirani | 30DAY |
| 256 | 150 Minutes - ₦2,350 (30 days) | kirani | 30DAY |
| 257 | 200 Minutes - ₦3,100 (30 days) | kirani | 30DAY |
| 258 | 250 Minutes - ₦3,900 (30 days) | kirani | 30DAY |
| 259 | 300 Minutes - ₦4,600 (30 days) | kirani | 30DAY |
| 260 | 350 Minutes - ₦5,350 (30days) | kirani | 30DAY |
| 261 | 400 Minutes - ₦6,100 (30 days) | kirani | 30DAY |
| 262 | 500 Minutes - ₦7,600 (30 days) | kirani | 30DAY |
| 263 | 600 Minutes - ₦9,250 (30 days) | kirani | 30DAY |
| 264 | 700 Minutes - ₦10,800 (30 days) | kirani | 30DAY |
| 265 | 800 Minutes - ₦12,300 (30 days) | kirani | 30DAY |
| 266 | 900 Minutes - ₦13,850 (30 days) | kirani | 30DAY |
SMILE (81 plans)
| ID | Plan | Type | Validity |
|---|---|---|---|
| 280 | SmileMINI 1GB - ₦450 (1 days) | smile | 1DAY |
| 214 | 1GB flexidaily - ₦450 (1 days) | smile | 1DAY |
| 281 | Smile MINI 2.5GB - ₦750 (1 days) | smile | 1DAY |
| 282 | Smile MINI 1GB - ₦750 (7 days) | smile | 7DAY |
| 215 | 2.5GB FlexiDaily - ₦750 (2 days) | smile | 2DAY |
| 216 | 1GB flexiweekly - ₦750 (30 days) | smile | 30DAY |
| 283 | SmileVoice ONLY 65 - ₦900 (30 days) | smile | 30DAY |
| 209 | SmileVoice ONLY 65 - ₦900 (30 days) | smile | 30DAY |
| 240 | 2GB midnight - ₦1,100 (7days ) | smile | 7DAY |
| 284 | Smile MIDI 1.5GB - ₦1,250 (30 days) | smile | 30DAY |
| 285 | Smile MIDI 2GB - ₦1,500 (30 days) | smile | 30DAY |
| 286 | Smile MINI 3GB - ₦1,500 (2 days) | smile | 2DAY |
| 287 | Smile MINI 3.5GB - ₦1,500 (7 days) | smile | 7DAY |
| 219 | 2GB FlexiWeekly - ₦1,550 (7days) | smile | 7DAY |
| 220 | 1.5GB Bigga - ₦1,550 (30days) | smile | 30DAY |
| 241 | 3GB midnight - ₦1,650 (7days ) | smile | 7DAY |
| 242 | 3GB weekend only - ₦1,650 (1 weekend) | smile | 1WEEK |
| 288 | SmileVoice ONLY 135 - ₦1,850 (30 days) | smile | 30DAY |
| 210 | SmileVoice ONLY 135 - ₦1,850 (30 days) | smile | 30DAY |
| 289 | Smile MIDI 3GB - ₦2,000 (30 days) | smile | 30DAY |
| 290 | Smile MINI 5GB - ₦2,200 (2 days) | smile | 2DAY |
| 291 | Smile MINI 6GB - ₦2,300 (7 days) | smile | 7DAY |
| 222 | 3GB Bigga - ₦2,300 (30days) | smile | 30DAY |
| 292 | SmileVoice ONLY 150 - ₦2,700 (60 days) | smile | 60DAY |
| 217 | SmileVoice ONLY 150 - ₦2,700 (60days) | smile | 60DAY |
| 293 | Smile MIDI 6GB - ₦3,000 (30 days) | smile | 30DAY |
| 223 | 5GB Bigga - ₦3,100 (30days) | smile | 30DAY |
| 294 | Smile MIDI 8GB - ₦3,500 (30 days) | smile | 30DAY |
| 295 | SmileVoice ONLY 175 - ₦3,600 (90 days) | smile | 90DAY |
| 218 | SmileVoice ONLY 175 - ₦3,600 (90days) | smile | 90DAY |
| 224 | 6.5GB Bigga - ₦3,800 (30 days) | smile | 30DAY |
| 296 | Smile MIDI 10GB - ₦4,000 (30 days) | smile | 30DAY |
| 225 | 10GB Bigga - ₦4,600 (30days) | smile | 30DAY |
| 297 | Smile MIDI 13GB - ₦5,000 (30 days) | smile | 30DAY |
| 298 | Freedom Mobile Plan - ₦5,000 (30 days) | smile | 30DAY |
| 299 | SmileVoice ONLY 430 - ₦5,700 (30 days) | smile | 30DAY |
| 211 | SmileVoice ONLY 430 - ₦5,700 (30 days) | smile | 30DAY |
| 300 | Smile MIDI 18GB - ₦6,000 (30 days) | smile | 30DAY |
| 301 | Smile MIDI 20GB - ₦7,000 (30 days) | smile | 30DAY |
| 302 | SmileVoice ONLY 450 - ₦7,200 (60 days) | smile | 60DAY |
| 212 | SmileVoice ONLY 450 - ₦7,200 (60 days) | smile | 60DAY |
| 232 | 20GB Bigger - ₦8,000 (30 days) | smile | 30DAY |
| 303 | SmileVoice ONLY 500 - ₦9,000 (90 days) | smile | 90DAY |
| 304 | Smile MIDI 25GB - ₦9,000 (30 days) | smile | 30DAY |
| 213 | SmileVoice ONLY 500 - ₦9,000 (90days) | smile | 90DAY |
| 233 | 25GB Bigger - ₦9,500 (30 days) | smile | 30DAY |
| 305 | Smile MIDI 40GB - ₦12,500 (30 days) | smile | 30DAY |
| 234 | 30GB Bigger - ₦12,500 (30 days) | smile | 30DAY |
| 306 | Smile ANNUAL 20GB - ₦14,000 (365 days) | smile | 365DAY |
| 226 | 15GB 365 - ₦14,000 (360 days) | smile | 360DAY |
| 307 | Smile MAXI Lite - ₦15,000 (30 days) | smile | 30DAY |
| 308 | Smile MIDI 65GB - ₦15,000 (30 days) | smile | 30DAY |
| 238 | Smile Maxi Lite - ₦15,000 (30 days) | smile | 30DAY |
| 235 | 40 Bigger - ₦15,500 (30 days) | smile | 30DAY |
| 221 | 2GB Bigga - ₦18,000 (30days) | smile | 30DAY |
| 309 | Smile MIDI 100GB - ₦20,000 (30 days) | smile | 30DAY |
| 236 | 60 Bigger - ₦21,000 (30 days) | smile | 30DAY |
| 237 | 75 Bigger - ₦23,000 (30 days) | smile | 30DAY |
| 310 | Smile MIDI 130GB - ₦25,000 (30 days) | smile | 30DAY |
| 311 | Smile JUMBO 90GB - ₦25,000 (60 days) | smile | 60DAY |
| 312 | Smile MAXI Essential - ₦27,700 (30 days) | smile | 30DAY |
| 239 | Smile MAXI Essentials - ₦27,700 (30 days) | smile | 30DAY |
| 313 | Smile ANNUAL 50GB - ₦29,000 (365 days) | smile | 365DAY |
| 228 | 35GB 365 - ₦29,000 (360 days) | smile | 360DAY |
| 229 | 90GB Jumbo - ₦31,000 (60days) | smile | 60DAY |
| 314 | Smile Maxi Home - ₦38,500 (30 days) | smile | 30DAY |
| 243 | Smile Maxi Home - ₦38,500 (30 days) | smile | 30DAY |
| 315 | Smile MIDI 210GB - ₦40,000 (30 days) | smile | 30DAY |
| 316 | Smile MAXI Office - ₦45,000 (30 days) | smile | 30DAY |
| 231 | Smile Maxi Office - ₦45,000 (30 days) | smile | 30DAY |
| 317 | Smile ANNUAL 120GB - ₦49,500 (365 days) | smile | 365DAY |
| 318 | Smile JUMBO 300GB - ₦50,000 (90 days) | smile | 90DAY |
| 230 | 160GB Jumbo - ₦53,000 (90days ) | smile | 90DAY |
| 319 | Smile JUMBO 350GB - ₦60,000 (120 days) | smile | 120DAY |
| 320 | Smile MAXI DataFlux - ₦61,500 (30 days) | smile | 30DAY |
| 227 | Smile MAXI Data Flux - ₦61,500 (30 days) | smile | 30DAY |
| 321 | Smile JUMBO 500GB - ₦77,000 (180 days) | smile | 180DAY |
| 322 | Smile ANNUAL 250GB - ₦77,000 (365 days) | smile | 365DAY |
| 323 | Smile ANNUAL 450GB - ₦107,000 (365 days) | smile | 365DAY |
| 324 | Smile ANNUAL 700GB - ₦154,000 (365 days) | smile | 365DAY |
| 325 | Smile ANNUAL 1TB - ₦180,000 (365 days) | smile | 365DAY |
MTN (79 plans)
| ID | Plan | Type | Validity |
|---|---|---|---|
| 46 | 18.6GB Always On [5500] | ALWAYS ON | 30 Days |
| 47 | 45GB Always On [9000] | ALWAYS ON | 30 Days |
| 329 | 4GB 2-Days | AWOOF | 2 Days |
| 331 | 5GB 2-Days | AWOOF | 2 Days |
| 330 | 6.5GB 2-Days | AWOOF | 2 Days |
| 328 | 8GB 2-Days | AWOOF | 2 Days |
| 1 | 500MB DT | DATA TRANSFER | 7 Days |
| 2 | 1GB DT | DATA TRANSFER | 7 Days |
| 3 | 2GB DT | DATA TRANSFER | 7 Days |
| 4 | 3GB DT | DATA TRANSFER | 7 Days |
| 5 | 5GB DT | DATA TRANSFER | 7 Days |
| 7 | 75MB Daily [75] | GIFTING | 1 Day |
| 9 | 110MB Daily [100] | GIFTING | 1 Day |
| 11 | 230MB Daily [200] | GIFTING | 1 Day |
| 12 | 500MB Daily [350] | GIFTING | 1 Day |
| 14 | 750MB + 1HR(YT/IG/TT) [450] | GIFTING | 2 Days |
| 13 | 1GB + 1.5MINS Daily [500] | GIFTING | 1 Day |
| 24 | 500MB Weekly [500] | GIFTING | 7 Days |
| 17 | 1.5GB 2-Days [600] | GIFTING | 2 Days |
| 15 | 2.5GB Daily [750] | GIFTING | 1 Day |
| 18 | 2GB 2-Days [750] | GIFTING | 2 Days |
| 25 | 1.2GB + 1HR(YT/IG/TT) [750] | GIFTING | 7 Days |
| 26 | 1GB Weekly [800] | GIFTING | 7 Days |
| 19 | 2.5GB 2-Days [900] | GIFTING | 2 Days |
| 16 | 3.5GB Daily [1000] | GIFTING | 1 Day |
| 20 | 3.2GB 2-Days [1000] | GIFTING | 2 Days |
| 27 | 1.5GB Weekly [1000] | GIFTING | 7 Days |
| 21 | 4GB 2-Days [1200] | GIFTING | 2 Days |
| 22 | 5.5GB 2-Days [1500] | GIFTING | 2 Days |
| 28 | 3.5GB Weekly [1500] | GIFTING | 7 Days |
| 37 | 2GB + 2MINS Monthly [1500] | GIFTING | 30 Days |
| 23 | 7GB 2-Days [1800] | GIFTING | 2 Days |
| 38 | 2.7GB + 2MINS Monthly [2000] | GIFTING | 30 Days |
| 29 | 6GB Weekly [2500] | GIFTING | 7 Days |
| 39 | 3.5GB + 5MINS Monthly [2500] | GIFTING | 30 Days |
| 30 | 11GB Weekly [3500] | GIFTING | 7 Days |
| 41 | 7GB Monthly [3500] | GIFTING | 30 Days |
| 31 | 15GB Weekly [4000] | GIFTING | 7 Days |
| 33 | 12.5GB 2-Weeks Plan [4500] | GIFTING | 14 Days |
| 42 | 10GB + 10MINS Monthly [4500] | GIFTING | 30 Days |
| 32 | 20GB Weekly [5000] | GIFTING | 7 Days |
| 44 | 12.5GB Monthly [5500] | GIFTING | 30 Days |
| 34 | 18GB 2-Weeks Plan [6000] | GIFTING | 14 Days |
| 45 | 16.5GB + 10MINS Monthly [6500] | GIFTING | 30 Days |
| 49 | 20GB Monthly [7500] | GIFTING | |
| 35 | 28GB 2-Weeks Plan [8000] | GIFTING | 14 Days |
| 50 | 25GB Monthly [9000] | GIFTING | 30 Days |
| 36 | 40GB 2-Weeks Plan [10000] | GIFTING | 14 Days |
| 52 | 36GB Monthly [11000] | GIFTING | 30 Days |
| 53 | 65GB Monthly [16000] | GIFTING | 30 Days |
| 54 | 75GB Monthly [18000] | GIFTING | 30 Days |
| 57 | 90GB 2-Month Plan [25000] | GIFTING | 60 Days |
| 55 | 165GB Monthly [35000] | GIFTING | 30 Days |
| 58 | 150GB 2-Month [40000] | GIFTING | 60 Days |
| 56 | 250GB Monthly [55000] | GIFTING | 30 Days |
| 59 | 480GB 3-Month [90000] | GIFTING | 90 Days |
| 60 | 800GB Yearly [125000] | GIFTING | 365 Days |
| 69 | 30GB Monthly Mifi [9000] | MIFI | 30 Days |
| 70 | 60GB Monthly Mifi [14500] | MIFI | 30 Days |
| 71 | 120GB Monthly Mifi [25000] | MIFI | 30 Days |
| 72 | Silver (150GB FUP Monthly Mifi [30000] | MIFI | 30 Days |
| 73 | Silver (260GB FUP Monthly Mifi [45000] | MIFI | |
| 48 | 25GB Postpaid Monthly [7000] | POSTPAID | 30 Days |
| 180 | 40GB Postpaid 3-month [9000] | POSTPAID | 90 Days |
| 267 | MTN 500 MB | SME | 30 Days |
| 268 | MTN 1 GB | SME | 30 Days |
| 269 | MTN 2 GB | SME | 30 Days |
| 271 | MTN 5 GB | SME | 30 Days |
| 270 | MTN 3 GB | SME | 30 Days |
| 61 | 200MB Social Daily [100] | SOCIAL | 1 Day |
| 62 | 470MB Social Weekly [200] | SOCIAL | 7 Days |
| 64 | 1.2GB Social Daily [450] | SOCIAL | 30 Days |
| 65 | ThryveTalk Bundles 1500(110 MINS, 300MB, 105 SMS UNITS) | THRYVE | 30 Days |
| 67 | ThryveData 1500(35 MINS, 1.8GB, 150 SMS UNITS) | THRYVE | 30 Days |
| 66 | ThryveTalk Bundles 3000(250 MINS, 1GB, 75 SMS UNITS) | THRYVE | 30 Days |
| 68 | ThryveData 3000(90 MINS, 5GB, 220 SMS UNITS) | THRYVE | 30 Days |
| 40 | 6.75GB Value Data [3000] | VALUE DATA | 30 Days |
| 43 | 14.5GB Value Data [5000] | VALUE DATA | 30 Days |
| 51 | 20GB Value Data [10000] | VALUE DATA | 30 Days |
GLO (25 plans)
| ID | Plan | Type | Validity |
|---|---|---|---|
| 135 | 6.1GB 15 Days [2000] | ALWAYS ON | 15 Days |
| 136 | 15GB 30 Days [3500] | ALWAYS ON | |
| 137 | 30GB 30 Days [5000] | ALWAYS ON | 30 Days |
| 138 | 45GB 30 Days [7000] | ALWAYS ON | 30 Days |
| 129 | 350MB 1 Night [60] | NIGHT | 1 Day |
| 130 | 750MB 1 Night [120] | NIGHT | |
| 273 | 1 GB AWOOF | SME | 3 Days |
| 276 | 1 GB AWOOF | SME | 7 Days |
| 274 | 3 GB AWOOF | SME | 3 Days |
| 277 | 3 GB AWOOF | SME | 7 Days |
| 275 | 5 GB AWOOF | SME | 3 Days |
| 278 | 5 GB AWOOF | SME | 7 Days |
| 145 | 300MB Daily for Social Media [100] | SOCIAL | 1 Day |
| 146 | 1GB 3-day for Social Media [300] | SOCIAL | 3 Days |
| 147 | 1.5GB Weekly for Social Media [500] | SOCIAL | 7 Days |
| 148 | 3.5GB 3-day for Social Media [1000] | SOCIAL | 30 Days |
| 193 | Talk More - 5MINS 1DAY | TALK MORE | 1 Day |
| 194 | Talk More - 10MINS 3DAYS | TALK MORE | 3 Days |
| 195 | Talk More - 21MINS 7DAYS | TALK MORE | 7 Days |
| 196 | Talk More - 31MINS 7DAYS | TALK MORE | 7 Days |
| 197 | Talk More - 52MINS 15DAYS | TALK MORE | 15 Days |
| 198 | Talk More - 105MINS 15DAYS | TALK MORE | 15 Days |
| 199 | Talk More - 160MINS 30DAYS | TALK MORE | 30 Days |
| 200 | Talk More - 215MINS 30DAYS | TALK MORE | 30 Days |
| 201 | Talk More - 270MINS 30DAYS | TALK MORE | 30 Days |
AIRTEL (51 plans)
| ID | Plan | Type | Validity |
|---|---|---|---|
| 326 | 1GB | AWOOF | 1day |
| 327 | 2.5GB | AWOOF | 1day |
| 89 | 1GB Daily Binge | BINGE | 1 Day |
| 90 | 2GB 2-Day Binge | BINGE | 2 Days |
| 91 | 3GB 2-Day Binge | BINGE | 2 Days |
| 92 | 4GB 2-Day Binge | BINGE | 2 Days |
| 93 | 6GB 2-Day Binge | BINGE | 2 Days |
| 63 | 250MB Daily [50] | GIFTING | 1 Day |
| 81 | 75MB Daily [75] | GIFTING | 1 Day |
| 82 | 110MB Daily [100] | GIFTING | 1 Day |
| 83 | 230MB 2-Day [200] | GIFTING | 1 Day |
| 84 | 300MB 2-Day [300] | GIFTING | 2 Days |
| 94 | 500MB Weekly [500] | GIFTING | 7 Days |
| 95 | 1GB Weekly [800] | GIFTING | 7 Days |
| 96 | 1.5GB Weekly [1000] | GIFTING | 7 Days |
| 97 | 4GB Weekly [1500] | GIFTING | 7 Days |
| 102 | 2GB Monthly [1500] | GIFTING | 30 Days |
| 98 | 6GB Weekly [2000] | GIFTING | 7 Days |
| 103 | 3GB Monthly [2000] | GIFTING | 30 Days |
| 99 | 8GB Weekly [2500] | GIFTING | 7 Days |
| 104 | 4GB Monthly [2500] | GIFTING | 30 Days |
| 100 | 10GB Weekly [3000] | GIFTING | 7 Days |
| 105 | 8GB Monthly [3000] | GIFTING | 30 Days |
| 106 | 10GB Monthly [4000] | GIFTING | 30 Days |
| 101 | 20GB Weekly [5000] | GIFTING | 7 Days |
| 107 | 13GB Monthly [5000] | GIFTING | 30 Days |
| 108 | 18GB Monthly [6000] | GIFTING | 30 Days |
| 109 | 25GB Monthly [8000] | GIFTING | 30 Days |
| 110 | 35GB Monthly [10000] | GIFTING | 30 Days |
| 112 | 60GB Monthly [15000] | GIFTING | 30 Days |
| 113 | 100GB Monthly [20000] | GIFTING | 30 Days |
| 114 | 160GB Monthly [30000] | GIFTING | 30 Days |
| 115 | 210GB Monthly [40000] | GIFTING | 60 Days |
| 116 | 300GB 3-Month [50000] | GIFTING | 90 Days |
| 117 | 350GB 4-Month [60000] | GIFTING | 120 Days |
| 118 | 685GB Yearly [100000] | GIFTING | 365 Days |
| 86 | 200MB 2-Days Social | SOCIAL | 2 Days |
| 87 | 1GB 3-Days Social | SOCIAL | 3 Days |
| 85 | 500MB 2-Day [350] | SOCIAL | 2 Days |
| 88 | 1.5GB Weekly Social | SOCIAL | 7 Days |
| 187 | Talk More N100 - 10 Minutes | TALK MORE | 3 Days |
| 188 | Talk More N200 - 20 Minutes | TALK MORE | 7 Days |
| 189 | Talk More N300 - 30 Minutes | TALK MORE | 7 Days |
| 190 | Talk More N500 - 50 Minutes | TALK MORE | 14 Days |
| 191 | Talk More N1000 - 100 Minutes | TALK MORE | 14 Days |
| 192 | Talk More N1500 - 150 Minutes | TALK MORE | 30 Days |
| 181 | UNLIMITED 50MBPS [25000] | UNLIMITED | 30 Days |
| 182 | UNLIMITED 20MBPS [30000] | UNLIMITED | 30 Days |
| 184 | UNLIMITED 100MBPS [45000] | UNLIMITED | 30 Days |
| 185 | UNLIMITED 60MBPS [50000] | UNLIMITED | 30 Days |
| 186 | UNLIMITED 20MBPS [80000] | UNLIMITED | 90 Days |
Cable plan IDs
Send the package ID as plan_id to /cabletv, and the provider's cable_id to /validate-cable.
No cable plans are active right now.
Electricity company IDs
Send as disco_id to /validate-meter and /electricity.
| disco_id | Company |
|---|---|
| 13 | Aba Electricity(APLE) |
| 6 | Abuja Electricity(AEDC) |
| 2 | Benin Electricity(BEDC) |
| 1 | Eko Electricity(EKEDC) |
| 17 | Enugu Electricity(EEDC) |
| 11 | Ibadan Electricity(IBEDC) |
| 4 | Ikeja Electricity(IKEDC) |
| 3 | Jos Electricity(JED) |
| 21 | Kaduna Electricity(KAEDCO) |
| 7 | Kano Electricity Distribution(KEDC) |
| 10 | Portharcourt Electricity(PHED) |
| 23 | Yola Electricity(YED) |
Exam types
Send the code as exam_name to /exam_pin.
| Code | Exam |
|---|---|
| WAEC | West African Examinations Council |
| NECO | National Examinations Council |
| NABTEB | National Business and Technical Examinations Board |
