How to fetch transaction data for all the bill payments made on your account

Raphael Ugwu

July 13, 2022

2 min

Table of Contents

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
  }