Fetch Energy Transaction Receipts

Testing Env

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

POST

/api/energy/transaction

Maintainer:Not configured

Returns a list of transaction receipts that match the supplied criteria.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

List of transaction receipts successfully retrieved

Body

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch/api/energy/transaction' \
--header 'X-ServiceAccount-ID: 123e4567-e89b-12d3-a456-426614174000' \
--header 'X-Organisation-ID: 123e4567-e89b-12d3-a456-426614174000' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "accountNumber": {
        "equals": "string",
        "notEquals": "string",
        "specified": true,
        "in": [
            "string"
        ],
        "notIn": [
            "string"
        ],
        "contains": "string",
        "doesNotContain": "string"
    },
    "fundsSourceAccount": {
        "equals": "string",
        "notEquals": "string",
        "specified": true,
        "in": [
            "string"
        ],
        "notIn": [
            "string"
        ],
        "contains": "string",
        "doesNotContain": "string"
    },
    "transactionDate": {
        "equals": "2019-08-24T14:15:22Z",
        "notEquals": "2019-08-24T14:15:22Z",
        "specified": true,
        "in": [
            "2019-08-24T14:15:22Z"
        ],
        "notIn": [
            "2019-08-24T14:15:22Z"
        ],
        "greaterThan": "2019-08-24T14:15:22Z",
        "lessThan": "2019-08-24T14:15:22Z",
        "greaterThanOrEqual": "2019-08-24T14:15:22Z",
        "lessThanOrEqual": "2019-08-24T14:15:22Z"
    }
}'

Response Example

200 - Example 1

{
    "code": 0,
    "message": {},
    "data": {},
    "correlationId": "string",
    "conversationId": "string",
    "requestId": "string",
    "initiatorId": "string",
    "billPaymentOrderReceipts": [
        {
            "transactionId": "string",
            "transactionDate": "2019-08-24T14:15:22Z",
            "invoiceAmount": 0,
            "faceValue": 0,
            "discount": 0,
            "fee": 0,
            "tax": 0,
            "levy": 0,
            "product": {
                "skuId": "string",
                "productName": "string",
                "faceValue": 0
            },
            "accountHolderEntity": {
                "entityId": "string",
                "entityReferenceAccountId": "string",
                "entityName": "string",
                "contactNumber": "string",
                "emailAddress": "string",
                "entityAddress": "string",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "string",
                "zipCode": "string",
                "country": "string",
                "vatNumber": "string",
                "firstName": "string",
                "lastName": "string",
                "entityProfileType": "ORGANIZATION"
            },
            "billPayerEntity": {
                "entityId": "string",
                "entityReferenceAccountId": "string",
                "entityName": "string",
                "contactNumber": "string",
                "emailAddress": "string",
                "entityAddress": "string",
                "addressLine1": "string",
                "addressLine2": "string",
                "city": "string",
                "state": "string",
                "zipCode": "string",
                "country": "string",
                "vatNumber": "string",
                "firstName": "string",
                "lastName": "string",
                "entityProfileType": "ORGANIZATION"
            },
            "billPaymentDetail": {
                "accountNumber": "string",
                "accountReferenceNumber": "string",
                "token": "string",
                "unit": "string",
                "unitValue": 0,
                "receiptNarration": "string",
                "localCurrencyAmount": 0,
                "localCurrencyAmountExcludingTax": 0,
                "salesTaxAmount": 0,
                "levyAmount": 0,
                "destinationCurrency": "string",
                "transactionDate": "2019-08-24T14:15:22Z",
                "transactionReference": "string",
                "paymentReference": "string"
            }
        }
    ],
    "itemPagination": {
        "totalElements": 0,
        "pageSize": 0,
        "totalPages": 0,
        "pageNumber": 0,
        "offSet": 0
    },
    "isSuccessful": true
}

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

Lookup Pay TV Account Copy

Fetch Latest Energy Voucher Transaction