REST API v1.0 • Stable Production

Developer API Documentation

Connect your web, mobile, or POS applications directly to Jamilpay's automated telecom infrastructure. Fast, reliable, and secure.

API Reference

Overview & Auth 1. Get Wallet Balance 2. Purchase Airtime 3. List Data Plans 4. Purchase Data Bundle 5. Cable TV Validation & Vend 6. Electricity Meter & Tokens 7. Query Transaction

Get Your API Keys

Authentication & Base URL

All API endpoints require HTTPS and must include your API Key in the HTTP Authorization header as a Bearer token.

# Base URL:

https://vtu.jamilsoft.com.ng/api/v1

# Header:

Authorization: Bearer jp_live_YOUR_API_KEY

Content-Type: application/json

GET /api/v1/balance

Query your current account wallet balance and profile status.

# Example Response (200 OK):

{
  "status": "success",
  "success": true,
  "message": "Wallet balance retrieved",
  "data": {
    "username": "jamil_tech",
    "balance": 85400.00,
    "currency": "NGN",
    "role": "reseller"
  }
}

POST /api/v1/airtime

Vend instant airtime to any Nigerian phone number.

Field	Type	Required	Description
network	string	Yes	MTN, AIRTEL, GLO, or 9MOBILE
phone	string	Yes	11-digit phone number (e.g. 08012345678)
amount	number	Yes	Recharge amount in NGN (min: ₦50)

# Request Body:

{
  "network": "MTN",
  "phone": "08012345678",
  "amount": 1000
}

POST /api/v1/data

Vend instant SME, Corporate Gifting, or Direct Data bundles.

# Request Body:

{
  "network": "MTN",
  "phone": "08012345678",
  "plan_id": 2
}

POST /api/v1/cable/validate

Validate IUC or SmartCard number to fetch customer name before renewing.

# Request Body:

{
  "provider": "GOTV",
  "smartcard": "2019882233"
}

POST /api/v1/electricity

Generate 20-digit prepaid electricity meter tokens.

# Request Body:

{
  "disco": "AEDC",
  "meter_number": "14128990123",
  "meter_type": "prepaid",
  "amount": 2500,
  "phone": "08012345678"
}

GET /api/v1/transaction?reference={reference}

Check the real-time status and token/receipt details of any transaction.