API Documentation

Integrate our VTU services into your application. Upgrade to API Client level to get your keys.

Authentication

All requests require your API keys in headers:

X-Public-Key: your_public_key
X-Secret-Key: your_secret_key
Content-Type: application/json

Base URL: https://proapp.paylux.com.ng/api/v1.php

Endpoints

GET ?action=balance

Check your wallet balance.

Response: {"status": "success", "balance": 5000.00}

POST ?action=airtime

Purchase airtime.

ParamTypeRequiredDescription
networkstringYesmtn, airtel, glo, 9mobile
phonestringYes11-digit phone number
amountnumberYesAmount (min 50)
// Request
{"network": "mtn", "phone": "08012345678", "amount": 100}

// Response
{"status": "success", "message": "Airtime sent", "reference": "AIR20260805..."}

POST ?action=data

Purchase data bundle.

ParamTypeRequiredDescription
networkstringYesmtn, airtel, glo, 9mobile
phonestringYesPhone number
plan_idnumberYesData plan ID

POST ?action=electricity

Pay electricity bill.

ParamTypeRequiredDescription
discostringYesDisCo code
meter_numberstringYesMeter number
meter_typestringYesprepaid or postpaid
amountnumberYesAmount (min 1000)

POST ?action=cable

Cable TV subscription.

ParamTypeRequiredDescription
providerstringYesgotv, dstv, startimes
plan_codestringYesPlan code
smartcard_numberstringYesSmartcard/IUC number

Error Responses

{"status": "error", "message": "Insufficient balance"}
{"status": "error", "message": "Invalid API key"}
{"status": "error", "message": "Missing required field: phone"}