× Integration Introduction page Airtime API Documentation Data API Documentation Cable TV API Documentation Electricity API Documentation Bulk SMS API Documentation Data Pin API Documentation Exam Pin API Documentation Internet Bundles API Documentation Recharge Card Pin API Documentation

Electricity Verification API Integration

(Live Environment)

This guide will help you integrate our Electricity Verification API into your system.

cURL Init Sample

curl -X POST https://vtunaija.com.ng/api/billpayment/verify/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"disco_name": "1",
"meter_number": "289645439"
}'

Successful API Response

{
"Status": "successful",
"status": "success",
"api_response": "Meter Verification Name gotten successfully",
"id": "78977865523",
"ident": "78977865523",
"Customer_Name": "Roland Johnson",
"name": "Roland Johnson",
"Customer_Address": "Abuja - Gwagwalada - Damin Kara"
}

Failed API Response

{
"Status": "failed",
"status": "fail",
"api_response": "Meter Name Verification Failed",
"id": "78977865523",
"ident": "78977865523"
}

Electricity API Integration

(Live Environment)

Welcome to the Electricity API Integration page. This guide will help you integrate our Electricity API into your system.

cURL Init Sample

curl -X POST https://vtunaija.com.ng/api/billpayment/ \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"disco_name": "1",
"meter_number": "289645439",
"MeterType": "prepaid",
"amount": "3000"
}'

Successful API Response

{
"Status": "successful",
"status": "success",
"api_response": "TRANSACTION SUCCESSFUL",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "3000",
"token": "Token: 076578558667856587587",
"electricitytoken": "Token: 076578558667856587587"
}

Failed API Response

{
"Status": "failed",
"status": "fail",
"api_response": "Failed Failed Failed. Something went wrong",
"id": "78977865523",
"ident": "78977865523",
"plan_amount": "0"
}

Post Terms Defined and Interpreted

disco_name: This field identifies the specific electricity service provider for which the user is making a bill payment. The *disco_name* field is represented by numbers such as 1, 2, 3, 4, 5, 6, etc., corresponding to various electricity companies in Nigeria. For the full list of Vtunaija Electricity IDs and Plan IDs, refer to API Documentation Page 1.

meter_number: This field specifies the electricity meter number for which the user intends to make a bill payment.

MeterType: This indicates the type of meter the user is paying for and can be either "prepaid" or "postpaid." The field is optional; if omitted in the API request, our server will default the *MeterType* to "prepaid."

amount: This field specifies the amount the user wishes to pay for the electricity bill.