Transaction Status Query

Transaction Status Query

Alternative to listening to events by using a webhook URL, you can request/call for the transaction status. This requires making a GET request at regular intervals to get the final status of a request.

Base URL: See Environments & Base URLs — single shared base URL for sandbox and production.

GET - {{baseurl}}/transaction/status/:reference

Header	Value
Authorization	Bearer SECRET_KEY
Content-type	application/json

Sample payload for transfer:

{
    "success": true,
    "message": "transaction fetched",
    "data": {
        "transaction": {
            "gatewayReference": null,
            "_id": "64f42c68ecfd2f6f1xxxxxxx",
            "transType": "transfer",
            "status": "pending",
            "feeAmount": 1500,
            "merchantId": "64459778bf350cc65xxxxxxx",
            "transactionReference": "1481fxxxxxxx",
            "userTransactionReference": "aedxxxx",
            "isRecurrent": false,
            "createdAt": "2023-09-03T06:49:12.509Z",
            "updatedAt": "2023-09-03T06:51:11.016Z",
            "amount": 100,
            "currency": "NGN",
            "recipient": {
                "recipientName": "John Doe",
                "currency": "NGN",
                "institutionType": "nuban",
                "institutionName": "Providus Bank",
                "institutionNumber": "54004xxxxx",
                "_id": "64f33cca80649e4fxxxxxxx"
            }
        },
        "authorizationCode": null
    }
}

Sample payload for collection (Re-charge disabled):

{
    "success": true,
    "message": "transaction fetched",
    "data": {
        "transaction": {
            "_id": "64fb69a68a6f0187bxxxxxxx",
            "transType": "collection",
            "status": "successful",
            "merchantId": "64459778bf350cc65xxxxxxx",
            "transactionReference": "401f69xxxxxx",
            "userTransactionReference": "aedxxxx",
            "customerEmail": "[e-mail]",
            "paymentCode": "ugjhxxxxx",
            "isRecurrent": false,
            "postProcess": null,
            "gatewayReference": null,
            "createdAt": "2023-09-08T18:36:22.214Z",
            "updatedAt": "2023-09-08T18:59:00.375Z",
            "feeAmount": 12.5,
            "amount": 50000,
            "currency": "NGN"
        },
        "authorizationCode": null
    }
}

Sample payload for collection (Re-charge enabled):

{
    "success": true,
    "message": "transaction fetched",
    "data": {
        "transaction": {
            "_id": "64fb69a68a6f0187bxxxxxxx",
            "transType": "collection",
            "status": "successful",
            "merchantId": "64459778bf350cc65xxxxxxx",
            "transactionReference": "401f69xxxxxx",
            "userTransactionReference": "aedxxxx",
            "customerEmail": "[e-mail]",
            "paymentCode": "ugjhvjhvv",
            "isRecurrent": false,
            "postProcess": null,
            "gatewayReference": null,
            "createdAt": "2023-09-08T18:36:22.214Z",
            "updatedAt": "2023-09-08T18:59:00.375Z",
            "feeAmount": 12.5,
            "amount": 50000,
            "currency": "NGN"
        },
        "authorizationCode": "5cb5047xxxxxxx"
    }
}

amount is in fractional unit.