Get Customer Paid Bills

Testing Env

https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch

GET

/api/bill-payments/payments

Maintainer:Not configured

This provides the list of bills that has already been paid by the customer.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200OK

application/json

Payments History successfully retrieved.

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch/api/bill-payments/payments?customerId=CUST-001245789' \
--header 'X-Request-ID: e2f3d567-8a9b-4e1e-9c4d-8c0f4f4a6d7b' \
--header 'X-ServiceAccount-ID: 98fd2a60-c2e1-4ad2-8772-3252a199ed99' \
--header 'X-Organisation-ID: 7ba45efb-543e-4978-b511-24f73b42a1b9' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "items": [
        {
            "billerTemplateId": "1",
            "companyCode": "550001",
            "companyDescription": "Airtel",
            "serviceProvided": "TELECOM",
            "serviceProvidedDescription": "Mobile",
            "category": "POSTPAID",
            "categoryDescription": "Post paid",
            "subCategory": "2GBDownload",
            "subCategoryDescription": "2GB per day",
            "furtherSubCategory": "Plan1299",
            "furtherSubCategoryDescription": "Plan 1299",
            "sourcePaymentReference": "6319df06-c695-4ae9-a6dc-06a2d68a1605",
            "paymentStatus": "SUCCESSFUL",
            "billReference": "550001",
            "customerIdWithBiller": "GT5482AB",
            "billCurrency": "EUR",
            "billAmount": 12.99,
            "chargeCurrency": "EUR",
            "totalChargeAmount": 0.44,
            "paymentCurrency": "EUR",
            "paymentAmount": 13.43,
            "debitAccountNumber": "47669210625",
            "paymentDate": "2019-08-24",
            "additionalData": [
                {
                    "custom-fields": {
                        "property1": "string",
                        "property2": "string"
                    }
                }
            ]
        }
    ],
    "links": {
        "self": {
            "href": "string",
            "templated": true
        },
        "first": {
            "href": "string",
            "templated": true
        },
        "next": {
            "href": "string",
            "templated": true
        },
        "prev": {
            "href": "string",
            "templated": true
        }
    }
}

Modified at 2025-07-10 05:30:41

Lookup Energy Bill Payer Account

Pay Bill