Keeping track of your bill payments is important, especially if you pay different bills for various services over an amount of time. This guide will walk you through how to achieve this. Steps to be followed in this guide are:
- Getting your access token for the utility payment service
- Retrieving your bill payment transaction details
You can get your access token by following the steps in this quickstart.
Retrieving bill payment transaction details
Assuming you want to view bill payment transaction details for your account , you can achieve this by making a request to Reloadly’s Utility Payments API. The cURL code snippet below shows how you can achieve this:
curl -i -X GET \
'https://utilities-sandbox.reloadly.com/transactions' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
If successful, you will receive a JSON snippet containing details of all the utility payments ever made on your account
{
"content": [
{
"code": "PAYMENT_PROCESSED_SUCCESSFULLY",
"message": "The payment was processed successfully",
"transaction": {
"id": 108,
"status": "SUCCESSFUL",
"referenceId": "may-electricity-bill",
"amount": 1000,
"amountCurrencyCode": "NGN",
"deliveryAmount": 1000,
"deliveryAmountCurrencyCode": "NGN",
"fee": 1198.32797,
"feeCurrencyCode": "NGN",
"discount": 0,
"discountCurrencyCode": "NGN",
"submittedAt": "2022-07-05 12:28:07",
"balanceInfo": {
"oldBalance": 792671.04742,
"newBalance": 790472.71945,
"cost": 2198.32797,
"currencyCode": "NGN",
"currencyName": "Nigerian Naira",
"updatedAt": "2022-07-05 16:28:07"
},
"billDetails": {
"type": "ELECTRICITY_BILL_PAYMENT",
"billerId": 5,
"billerName": "Ikeja Electricity Prepaid",
"billerCountryCode": "NG",
"serviceType": "PREPAID",
"completedAt": "2022-07-05 12:28:37",
"subscriberDetails": {
"accountNumber": "4223568280"
},
"pinDetails": {
"token": "4836-2318-0748-3623-1807",
"info1": null,
"info2": null,
"info3": null
}
}
}
},
{
"code": "PAYMENT_PROCESSED_SUCCESSFULLY",
"message": "The payment was processed successfully",
"transaction": {
"id": 107,
"status": "SUCCESSFUL",
"referenceId": "april-electricity-bill",
"amount": 1000,
"amountCurrencyCode": "NGN",
"deliveryAmount": 1000,
"deliveryAmountCurrencyCode": "NGN",
"fee": 1198.32797,
"feeCurrencyCode": "NGN",
"discount": 0,
"discountCurrencyCode": "NGN",
"submittedAt": "2022-07-05 10:55:03",
"balanceInfo": {
"oldBalance": 794869.37539,
"newBalance": 792671.04742,
"cost": 2198.32797,
"currencyCode": "NGN",
"currencyName": "Nigerian Naira",
"updatedAt": "2022-07-05 14:55:03"
},
"billDetails": {
"type": "ELECTRICITY_BILL_PAYMENT",
"billerId": 5,
"billerName": "Ikeja Electricity Prepaid",
"billerCountryCode": "NG",
"serviceType": "PREPAID",
"completedAt": "2022-07-05 10:55:05",
"subscriberDetails": {
"accountNumber": "4223568280"
},
"pinDetails": {
"token": "3717-9007-1537-1790-0715",
"info1": null,
"info2": null,
"info3": null
}
}
}
}
],
"pageable": {
"sort": {
"sorted": false,
"unsorted": true,
"empty": true
},
"pageNumber": 0,
"pageSize": 20,
"offset": 0,
"unpaged": false,
"paged": true
},
"totalPages": 1,
"totalElements": 4,
"last": true,
"sort": {
"sorted": false,
"unsorted": true,
"empty": true
},
"numberOfElements": 4,
"first": true,
"size": 20,
"number": 0,
"empty": false
}
