Developer API & Webhooks

Integrate HadiSub Airtime & Data automated engine into your apps and websites.

API Status: Active
Live API Credentials
REST API Documentation
API Base URL & Headers

All requests must include your Authorization header with your secret key.

Base URL: https://api.hadisub.ng/v1
Content-Type: application/json
Authorization: Bearer hs_sec_99d1234a9e401b7a20c388efc11a
Buy Airtime Endpoint
POST /v1/airtime/purchase 
curl -X POST https://api.hadisub.ng/v1/airtime/purchase \
  -H "Authorization: Bearer hs_sec_99d1234a9e401b7a20c388efc11a" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "MTN",
    "phone": "08031234567",
    "amount": 1000,
    "reference": "MY-AIRTIME-REF-001"
  }'
Sample JSON Response:
{
  "status": "success",
  "message": "Airtime successfully delivered",
  "data": {
    "reference": "TXN-83947291",
    "network": "MTN",
    "phone": "08031234567",
    "amount": 1000,
    "charged": 980.00,
    "balance_after": 124470.00
  }
}
Buy Data Bundle Endpoint
POST /v1/data/purchase 
curl -X POST https://api.hadisub.ng/v1/data/purchase \
  -H "Authorization: Bearer hs_sec_99d1234a9e401b7a20c388efc11a" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "MTN",
    "plan_id": "mtn-5gb",
    "phone": "08038492019",
    "reference": "MY-DATA-REF-002"
  }'
Sample JSON Response:
{
  "status": "success",
  "message": "MTN 5GB data bundle activated",
  "data": {
    "reference": "TXN-83947291",
    "network": "MTN",
    "phone": "08038492019",
    "plan": "5GB SME",
    "validity": "30 Days",
    "charged": 1420.00,
    "balance_after": 124030.00
  }
}
Check Reseller Balance Endpoint
GET /v1/wallet/balance 
curl -X GET https://api.hadisub.ng/v1/wallet/balance \
  -H "Authorization: Bearer hs_sec_99d1234a9e401b7a20c388efc11a"
Automated Webhooks

Receive real-time instant JSON callbacks when data or airtime transaction statuses resolve.