Get Airtime Transaction Receipts

Testing Env

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

GET

/api/airtime/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 ********************

Query Params

Header Params

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 GET 'https://sandbox.paypoint.blackkonnect.io/services/blackkonnectpaypointswitch/api/airtime/transaction' \
--header 'X-ServiceAccount-ID: 123e4567-e89b-12d3-a456-426614174000' \
--header 'X-Organisation-ID: 123e4567-e89b-12d3-a456-426614174000' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "code": 0,
    "message": {},
    "data": {},
    "correlationId": "string",
    "conversationId": "string",
    "requestId": "string",
    "initiatorId": "string",
    "topUpOrderReceipts": [
        {
            "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"
            },
            "topUpDetail": {
                "localCurrencyAmount": 0,
                "salesTaxAmount": 0,
                "localCurrencyAmountExcludingTax": 0,
                "destinationCurrency": "string",
                "operatorTransactionId": "string",
                "simInformation": {
                    "simNumber": "string",
                    "mobileNumber": "string"
                },
                "transactionDate": "2019-08-24T14:15:22Z",
                "transactionReference": "string"
            }
        }
    ],
    "itemPagination": {
        "totalElements": 0,
        "pageSize": 0,
        "totalPages": 0,
        "pageNumber": 0,
        "offSet": 0
    },
    "isSuccessful": true
}

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

Lookup Mobile Number Products

Get Transaction