Welcome to the Developer API. You can use our API to integrate VTU services directly into your application.
Base URL: https://api.payonce.com.ng/api/v1
All API requests must be authenticated using your API Key. Include the key in the request header.
x-api-key: YOUR_API_KEY_HERE
Fetch available service plans based on network and category.
network (string): mtn, airtel, glo, 9mobilecategory (string): data, airtime, cable, electricityGET /plans?network=mtn&category=data
Fetch available categories for a specific network.
network (string): mtn, airtel, glo, 9mobileserviceType (string): data, airtime, etc.GET /categories?network=mtn&serviceType=data
| Field | Type | Description |
|---|---|---|
| networkId | string | mtn, airtel, glo, 9mobile |
| phone | string | Recipient phone number |
| amount | number | Amount to purchase |
| airtimeType | string | VTU (optional, default: VTU) |
// Request Body
{
"networkId": "mtn",
"phone": "08012345678",
"amount": 100,
"airtimeType": "VTU"
}| Field | Type | Description |
|---|---|---|
| networkId | string | mtn, airtel, glo, 9mobile |
| planId | string | Plan ID from "Get Plans" endpoint |
| phone | string | Recipient phone number |
| amount | number | Plan price |
// Request Body
{
"networkId": "mtn",
"planId": "65f2...",
"phone": "08012345678",
"amount": 500
}Verify smartcard number before purchase.
// Request Body
{
"cableType": "dstv", // dstv, gotv, startimes
"smartCardNo": "1234567890"
}// Request Body
{
"provider": "dstv",
"planId": "65f...",
"smartCardNo": "1234567890",
"customerName": "John Doe",
"phone": "08012345678",
"amount": 2500
}// Request Body
{
"company": "ikejaelectric",
"metertype": "prepaid", // prepaid or postpaid
"meterno": "1234567890",
"amount": 1000 // optional, for validation
}// Request Body
{
"company": "ikejaelectric",
"type": "prepaid",
"meter_no": "1234567890",
"amount": 1000,
"planId": "65f...",
"phone": "08012345678"
}// Request Body
{
"planId": "65f...",
"noOfPin": 1
}