https://subremit.com/api/verify_electricity.php?username=****&apiKey=****&service=****&meterNumber=****&meterType=****
//Replace **** with your username, api key...
E.g.
https://subremit.com/api/verify_electricity.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&service=AEDC&meterNumber=45036572027&meterType=PRE
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, service is AEDC, meterNumber is 45036572027, meterType is PRE
JSON Format:
{"status":"success","customerName":"Ajibola Bolaji"}
Else, if there is an error in your request, the response will be displayed in this format:
{"error":"ERR210","description":"Error! Invalid meter number. Meter Number is unable to be validated."}
| Parameter_Name | Description |
|---|---|
| username | Your Subremit username |
| apiKey | Your Subremit API Key |
| service | service code, click Here to see |
| meterNumber | meter number |
| meterType | PRE or POST (UPPERCASE) - PRE for prepaid, POST for postpaid |
| amount | amount of electricity bills - minimum 1000 |
https://subremit.com/api/electricity.php?username=****&apiKey=****&service=****&meterNumber=****&meterType=****&amount=****
//Replace **** with your username, api key...
E.g.
https://subremit.com/api/electricity.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&service=AEDC&meterNumber=45036572027&meterType=PRE&amount=2000
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, service is AEDC, meterNumber is 45036572027, meterType is PRE, amount is 2000
JSON Format:
{"status":"Approved","trans_id":"88c4r5one73","service":"Abuja Electric - AEDC","MeterType":"PRE","MeterNo":"45036572027","MeterToken":"6646-4560-2879-0511-8019","amount":"2000","balance":"2500"}
Else, if there is an error in your request, one of the responses below will be displayed in this format:
{"error":"ERR201","description":"Invalid Username or Api Key"}
status can be - Pending, Approved or Cancelled
| Error | Description |
|---|---|
| ERR200 | Username Field Is Empty |
| ERR201 | Invalid Username or Api Key |
| ERR202 | Invalid Meter number |
| ERR203 | Insufficient Balance |
| ERR204 | Invalid Service Code |
| ERR205 | Less Than Minimum Amount |
| ERR206 | Order Not Processed |
| ERR208 | Meter Type does not tally with Service |
https://subremit.com/api/query_electricity.php?username=****&apiKey=****&trans_id=****
//Replace **** with your username, api key...
E.g.
https://subremit.com/api/query_electricity.php?username=Peter&apiKey=sag8rqpfa8vkpn1ler56ygh8kxxw1aor8&trans_id=88c4r5one73
//where username is Peter, apiKey is sag8rqpfa8vkpn1ler56ygh8kxxw1aor8, trans_id is 88c4r5one73
JSON Format:
{"status":"Approved","trans_id":"88c4r5one73","service":"Abuja Electric - AEDC for 45036572027","MeterNo":"45036572027","MeterToken":"6646-4560-2879-0511-8019","amount":"2000"}
Else, if there is an error in your request, response will be displayed in this format:
{"error":"ERR210","description":"Transaction not found on Subremit"}
| Service code | Distributor |
|---|---|
| IKEDC | Ikeja Electric |
| EKEDC | Eko Electric |
| AEDC | Abuja Electric |
| KEDC | Kano Electric |
| JEDC | Jos Electric |
| IBEDC | Ibadan Electric |
| KAEDC | Kaduna Electric |
| EEDC | Enugu Electric |
| PhED | Port Harcourt Electric |