TRANSACTION STATUS REQUERY

This endpoint allows you to retrieve data such as status of transaction using the request_id you supplied.

Using a POST method, transaction status can be queried with the endpoint below:

Live: https://vtpass.com/api/requery

Sandbox: https://sandbox.vtpass.com/api/requery

FIELDS Mandatory/Optional TYPE DESCRIPTION
request_id M String This is the unique reference provided when carrying out the transaction.

 

EXPECTED RESPONSE

{
    "response_description": "TRANSACTION SUCCESSFUL",
    "code": "000",
    "content": {
        "transactions": {
            "status": "delivered",
            "product_name": "MTN Airtime VTU",
            "unique_element": "08011111111",
            "unit_price": 20,
            "quantity": 1,
            "service_verification": null,
            "channel": "api",
            "commission": 1,
            "total_amount": 19.3,
            "discount": null,
            "type": "Airtime Recharge",
            "email": "sandbox@sandbox.vtpass.com",
            "phone": "123450987623",
            "name": null,
            "extras": null,
            "convinience_fee": 0,
            "amount": 20,
            "platform": "api",
            "method": "wallet",
            "transactionId": "17415980564672211596777904",
            "product_id": 2,
            "commission_details": {
                "amount": 1,
                "rate": "3.50",
                "rate_type": "percent",
                "computation_type": "default"
            }
        }
    },
    "requestId": "2025031010146932932",
    "amount": 20,
    "transaction_date": "2025-03-10T09:14:16.000000Z",
    "purchased_code": ""
}

You can check out the complete list of RESPONSE CODES HERE.