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.