API Reference Re-Query Transaction

Re-Query Transaction

GET

This service allows you to retrieve detailed information or confirm the status of a previous transaction . It is particularly useful for retry implementations 🔄.

By using the Reference ID of an already initiated request, the final response of that transaction can be fetched to determine whether a retry should be triggered or not.

⚠️ Note: The first requery should be performed at least five (5) minutes ⏱️ after initiating the transaction.

Service Information

baseUrl/api/v1/requery
GET
Parameter Name Type M/O Description
loginId Numeric M Merchant id provided during integration
key String M Merchant’s (public) key
requestId String M Unique transaction Id for the request. Maxlength (36characters)
serviceId String M Corresponding service id for the request type. See "Services" section for the available services and corresponding service codes for each. 

BASE_URL?loginId=17777&key=Ttdedbdc482f277243b&requestId=10B2E6F123&serviceId=A01E
Parameter Name Type M/O Description
statusCode Numeric M Status of the transaction. 00 signifies success
statusDescription String M Corresponding description for the status code. 00=Successful
mReference Numeric M Unique transaction id supplied by the integrator for the request
tranxReference Numeric M Merchant/client’s initial transaction reference
recipient Numeric M Customers phone number to top-up
amount Numeric M Amount with which to top-up amount customers phone Maximum 100000
Network string M The actual network fulfilled by the Telco 
{
    "statusCode": "00","statusDescription": "Successful","tranxReference": 2052544278,"recipient": "08069314541",
    "amount": "50.00","network": "MTN","mReference": "06773950c8ab","transactionDate": "2018-11-26 22:17:18"
}