Get Transaction Details

The initial search operations would have returned a data object containing a transaction_id.

You use this to make subsequent call to get the Full details of the transaction.

POST Get Transaction Details

👍

<https://switch-online-gateway-service.k9.isw.la/switch-online-gateway-service/api/v1/gateway/transaction

Authorization

AuthorizationBearer TokenComments
TokenRefer to Authentication

Header

KeyValueComments
client_idYour Client ID generated for your Project on the Developer ConsoleLogin to get your Authentication

Query Params

KeyValueComments
transaction_id
Page_size20
page_number1

Response Body

Response ParametersDescriptionComments
timestamptime of Search Operation
response message
responseCodetransaction number originating from terminal
dataObject containing some information for a transaction.The transaction_id in is then used to get details for the transaction. See how it's done here

Response Payload

{
    "timeStamp": "2023-11-07T17:41:48.706+00:00",
    "responseMessage": "Transactions Received Successfully",
    "responseCode": "202",
    "dataSize": 1,
    "totalPages": 1,
    "pageNumber": 10,
    "pageSize": 1,
    "data": [
        {
            "globalOutputData": {
                "category": "AGENCY BANKING CASHOUT",
                "amount": "630000",
                "transactionDate": "2023-10-03T17:47:35.240",
                "transactionStatus": "COMPLETED",
                "settlementDate": "2023-10-04",
                "settlementStatus": "SETTLED"
            },
            "transactionData": {
                "maskedPan": "506105*********9187",
                "terminalId": "2TEP5C7W",
                "stan": "002080",
                "channel": "POS",
                "rrn": "000000002080",
                "responseCode": "00",
                "messageType": "0200",
                "fromAccount": null,
                "beneficiaryAccount": null,
                "merchantName": null,
                "merchantLocation": null,
                "transactionReference": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                "cardType": null,
                "customerId": null,
                "merchantCode": "2TEPLA000000002",
                "responseMessage": "Approved or completed successfully",
                "currencyName": "NGN",
                "tranReversed": null
            },
            "settlementData": {
                "settlementBreakdownList": [
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "Acquirer_fee_payable",
                        "final_fee": -18.9,
                        "bank_code": "ZIB",
                        "transaction_category": "AGENCY BANKING CASHOUT",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    },
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "Acquirer_fee_payable",
                        "final_fee": -6.5,
                        "bank_code": "ZIB",
                        "transaction_category": "AGENCY BANKING CASHOUT (VERVE BILLING)",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    },
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "Amount_Payable",
                        "final_fee": -6300.0,
                        "bank_code": "FBN",
                        "transaction_category": "AGENCY BANKING CASHOUT",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    },
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "Amount_receivable",
                        "final_fee": 6300.0,
                        "bank_code": "ZIB",
                        "transaction_category": "AGENCY BANKING CASHOUT",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    },
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "ISW_fee_receivable",
                        "final_fee": 5.0,
                        "bank_code": "VEV",
                        "transaction_category": "AGENCY BANKING CASHOUT (VERVE BILLING)",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    },
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "ISW_fee_receivable",
                        "final_fee": 6.5,
                        "bank_code": "VEV",
                        "transaction_category": "AGENCY BANKING CASHOUT (VERVE BILLING)",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    },
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "ISW_fee_receivable",
                        "final_fee": 14.175,
                        "bank_code": "ISW",
                        "transaction_category": "AGENCY BANKING CASHOUT",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    },
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "Issuer_fee_receivable",
                        "final_fee": 4.725,
                        "bank_code": "FBN",
                        "transaction_category": "AGENCY BANKING CASHOUT",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    },
                    {
                        "unique_key": "000000002080_002080_2TEP5C7W_-630000.00_0200",
                        "final_fee_type": "issuer_fee_payable",
                        "final_fee": -5.0,
                        "bank_code": "FBN",
                        "transaction_category": "AGENCY BANKING CASHOUT (VERVE BILLING)",
                        "from_account_id": "3095931671",
                        "to_account_id": "48919400000901"
                    }
                ],
                "settlementDataAvailable": true
            },
            "disputeData": null
        }
    ],
    "errors": null
}

❗️

It is important to note that we have not reached 100% coverage YET for all Transactions. So, any Transaction not found should be reconfirmed on our Help Desk

You can Test out the API call directly here: