Electricity Payment API Integration

VALIDATE METER NUMBER

Base URL: https://billsalert.com.ng/api/merchant-verify/disco.php

SAMPLE CODE

$host="https://billsalert.com.ng/api/merchant-verify/disco.php?apikey=1234&service=ibadan-electric&meterNo=1022101199113&metertype=prepaid ";
//Initialize cURL.
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $host);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$data = curl_exec($ch);

//Close the cURL handle.
curl_close($ch);

$response = json_decode($data);
 
EXPECTED RESPONSE
{
    "code": 101,
    "description": {
        "Customer": "PAUL BECKY",
        "Address": "ELEME - PORTHARCOURT",
        "MeterNumber": "1022101199113"
    }
}


 

Generate Token
This endpoint allows you to generate electricity token using meter number.

Base URL: https://billsalert.com.ng/api/electric
Service: as specified in the fields below;
 




PARAMETERS
Required/Optional
TYPE
DESCRIPTION


apikey
R
String
The reseller gateway API key created at billsalert.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM


service
R
String
Service as specified. These includes, ikeja-electric, eko-electric, portharcourt-electric, jos-electric, kano-electric, ibadan-electric


meterNo
R
Number
The meter number to load the electricity token


metertype
R
String
This is the meter type. Example: prepaid or postpaid


amount
R
Number
The amount of electricity token you want to buy



ref
R
String
This is a unique reference with which you can use to execute and query the transaction.




 

SAMPLE CODE


$host ="https://billsalert.com.ng/api/electric?apikey=1234&service=ikeja-electric&meterNo=100221233&metertype=prepaid&amount=1000&ref=8284666332234";
//Initialize cURL.
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $host);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$data = curl_exec($ch);

//Close the cURL handle.
curl_close($ch);

$response = json_decode($data);



 

EXPECTED RESPONSE
{"code":101,
"description":{"Status":"TRANSACTION SUCCESSFUL",
"Token":"40364652026905256691",
"Units":"500 kWh",
"meterNumber":"100221233",
"product_name":"Ikeja Electric Payment - PHCN"
	
    }
}



                  

TV Payment API Integration

VALIDATE SMARTCARD/IUC NUMBER

Base URL: https://billsalert.com.ng/api/merchant-verify/

SAMPLE CODE

$host ="https://billsalert.com.ng/api/merchant-verify/?apikey=1234&service=gotv&smartNo=10022123";
//Initialize cURL.
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $host);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$data = curl_exec($ch);

//Close the cURL handle.
curl_close($ch);

$response = json_decode($data);
 

EXPECTED RESPONSE
{"code":101,
"description":{"Customer":"PAUL BECKY",
"Due_Date":"2019-07-23T00:00:00",
"Status":"Open"
	}
}


 

Recharge Decoder
This endpoint allows you to recharge GOTV/DSTV/Startimes decoder using it’s smartcard/IUC number.

Base URL: https://billsalert.com.ng/api/paytv
Service: as specified in the fields below;
 




PARAMETERS
Required/Optional
TYPE
DESCRIPTION


apikey
R
String
The reseller gateway API key created at billsalert.com.ng . Example kDe5dbBw3AeyxnxFCCJA9c9Agl2kxxt8pCB174AC472r38BCM


service
R
String
Service as specified. These includes, dstv, gotv, startimes


smartNo
R
Number
The smartcard or IUC number to make the subscription on


vcode
R
String
This is the Subscription Plam. Example: startimes_nova, strong>gotv_jinja, dstv_padi, etc


amount
O
Number
The amount of the Plan you want to subscribe and it is optional.



ref
R
String
This is a unique reference with which you can use to execute and query the transaction.




 

SAMPLE CODE


$host ="https://billsalert.com.ng/api/paytv?apikey=1234&service=gotv&smartNo=100221233&vcode=gotv_jinja&amount=3900&ref=8284666332234 ";
//Initialize cURL.
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $host);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$data = curl_exec($ch);

//Close the cURL handle.
curl_close($ch);

$response = json_decode($data);



 

EXPECTED RESPONSE
{"code":101,
"description":{"response_description":"TRANSACTION SUCCESSFUL",
"ref":"884666332234","amount":"3900",
"transaction_date":"2020-04-17 07:04:19"
}}



                  

Wallet Balance API

GET WALLET BALANCE

Base URL: https://billsalert.com.ng/api/balance

Service: as specified in the fields below;

SAMPLE CODE

$host ="https://billsalert.com.ng/api/balance?apikey=1234 ";
//Initialize cURL.
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $host);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);

$data = curl_exec($ch);

//Close the cURL handle.
curl_close($ch);

$response = json_decode($data);

EXPECTED RESPONSE

{"code":101,

"description":{"BALANCE":"45000.00",
	}

}