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

Electricity Verification API Integration

(Sandbox Environment) Register and Login on the Sandbox Website to get your Sandbox API Key for the Sandbox Integration Click Here

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

On Sandbox environment the meter number you are purchasing electricity token for must be 1111111111111 any other meter number that is not 1111111111111 the electricity token purchase request will fail.

cURL Init Sample

curl -X POST https://sandbox.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": "TESTMETER1",
"name": "TESTMETER1",
"Customer_Address": "ABULE - EGBA BU ABULE"
}

Failed API Response

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

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. On Sandbox environment the meter number must be 1111111111111 any other meter number that is not 1111111111111 the electricity token purchase request will fail

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.