Sell data from your own app

The Msub reseller API lets your website, app or bot buy data bundles for your customers. Purchases are paid from your Msub wallet at your API price.

Authentication

Send your API key in the X-API-Key header on every request. Get a key from API Access in your Msub dashboard; your account must be approved as an API user.

Copycurl https://api.msub.ng/api/v1/merchant/balance \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Accept: application/json"

Network IDs

Use these as network when buying.

Data plan IDs

Send the Plan ID as plan when buying. Your price for each plan is returned by List your plans. This list is also available as JSON from the public plan endpoint.

Wallet balance

Your current wallet balance.

Copycurl https://api.msub.ng/api/v1/merchant/balance -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "wallet": { "id": 12, "balance": 25000.00, "currency": "NGN" }
  }
}

List your plans

Every plan available to you, grouped by network, with your price. dataplan_id is the Plan ID to send when buying.

Copycurl https://api.msub.ng/api/v1/merchant/data/plans -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "MTN_PLAN": [
      {
        "dataplan_id": "42",
        "network": 1,
        "plan_network": "MTN",
        "plan_type": "SME",
        "plan": "1GB",
        "month_validate": "30 days",
        "plan_amount": "280.00"
      }
    ],
    "AIRTEL_PLAN": [], "GLO_PLAN": [], "9MOBILE_PLAN": []
  }
}

Buy data

Charges your wallet your price for the plan and sends the bundle to the number.

Copycurl -X POST https://api.msub.ng/api/v1/merchant/data/purchase \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"plan": "42", "network": 1, "mobile_number": "08031234567"}'

Copy$ch = curl_init('https://api.msub.ng/api/v1/merchant/data/purchase');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'X-API-Key: YOUR_API_KEY',
        'Content-Type: application/json',
        'Accept: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'plan' => '42',
        'network' => 1,
        'mobile_number' => '08031234567',
    ]),
]);
$result = json_decode(curl_exec($ch), true);

Copyconst res = await fetch("https://api.msub.ng/api/v1/merchant/data/purchase", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.MSUB_API_KEY,
    "Content-Type": "application/json",
    Accept: "application/json",
  },
  body: JSON.stringify({ plan: "42", network: 1, mobile_number: "08031234567" }),
});
const result = await res.json();

Copyimport requests

res = requests.post(
    "https://api.msub.ng/api/v1/merchant/data/purchase",
    headers={"X-API-Key": "YOUR_API_KEY", "Accept": "application/json"},
    json={"plan": "42", "network": 1, "mobile_number": "08031234567"},
)
result = res.json()

Success 200

{
  "success": true,
  "message": "Purchase successful.",
  "data": {
    "reference": "MSUBUTIL-7KQ2M9XW4R8T1B5N3P",
    "amount": 280.00,
    "plan": "MTN 1GB 30 days",
    "status": "success"
  }
}

Still confirming 202

The network has not confirmed yet. Your wallet stays debited while we confirm; check transaction status with the reference before retrying, so you don't buy twice.

{
  "success": false,
  "message": "This purchase is still being confirmed. It will be resolved shortly — your wallet has not been refunded yet.",
  "data": { "reference": "MSUBUTIL-7KQ2M9XW4R8T1B5N3P", "status": "pending" }
}

Failed 409

The purchase did not go through and your wallet has been refunded. Safe to retry.

Transaction status

Look up a purchase by the reference you got back (or its numeric id). status is pending, completed or failed.

Copycurl https://api.msub.ng/api/v1/merchant/transactions/MSUBUTIL-7KQ2M9XW4R8T1B5N3P -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "data": {
    "id": 9123,
    "reference": "MSUBUTIL-7KQ2M9XW4R8T1B5N3P",
    "amount": 280.00,
    "type": "debit",
    "status": "completed",
    "category": "utility_data",
    "phone_number": "08031234567",
    "created_at": "2026-10-13T09:41:00+01:00"
  }
}

Public plan IDs

The same plan list as above as JSON. No API key needed, and no prices. Handy for building your plan dropdown; refresh it daily as plans can change.

Copycurl https://api.msub.ng/api/v1/public/data-plans

{
  "success": true,
  "data": [
    { "plan_id": "42", "network_id": 1, "network": "MTN", "plan_type": "SME",
      "size": "1GB", "validity": "30 days", "name": "MTN 1GB 30 days" }
  ]
}

Responses & errors

{
  "success": false,
  "message": "Validation failed",
  "data": null,
  "errors": { "mobile_number": ["The mobile number field is required."] }
}

Need help? Contact Msub support from your dashboard.