get https://api-approval.tingg.africa/v3/checkout-api/query//
The query status is used by the merchant if they want to query for the status of the request they raised. In this case this is a GET request where the merchant passes service_code
and merchant_transaction_id
as part of the query parameters
Live Endpoint
https://api.tingg.africa/v3/checkout-api/query/JOHNDOEONLINESERVICE/676
Key | Value Type | Required | Description |
---|---|---|---|
service_code | String | Yes | The merchant's service code. |
merchant_transaction_id | String | Yes | Unique transaction ID identifying the transaction as given by the merchant. |
Request Status Codes
Status Code | Description |
---|---|
129 | Request has expired with no partial payment received. |
130 | New request raised by the merchant. |
176 | Partial payment made for the request and has been marked as closed. Available for merchants who accept partial payments for their request |
178 | Full payment made for the request. |
179 | Request has expired with one or more partial payments made. The partial payment(s) will be reversed. |
180 | Request Fully paid for but acknowledged as rejected by the merchant. |
183 | Request fully paid for but acknowledged as accepted by the merchant. |
99 | A failed payment has been received for this request. Request is still open to receive payments |
188 | The payment was received by the merchant. An accept/reject call will be initiated later by merchant. |
184 | This is indicates that a refund of part of the request amount has been initiated. |
185 | This is indicates that full refund the request amount has been initiated. |
186 | This is indicates that the part refund for the request was successfully processed. |
187 | This is indicates that the full refund for the request was successfully processed. |
Response Status Codes
Status Code | Description |
---|---|
200 | Success. Checkout request successfully logged in the checkout platform. |
500 | Failure. Generic failure occurred. Could be as a result of a system failure on the checkout platform. |
1001 | No request found. |
1007 | Missing country code. The checkout request posted was missing a country_code |
1013 | Not JSON. The checkout request posted was not valid JSON |
1014 | Missing merchant transaction id. The request did not have a merchant_transaction_id |
1015 | Missing checkout request id.The request did not have a checkout_request_id |
1017 | Invalid charge msisdn provided. The charge_msisdn provided was not valid in the country provided |
1027 | Invalid amount provided. The charge_amount should be between the minimum and maximum amounts provided for the payment option. |
173 | Request initiated successfully |
422 | Invalid request |
191 | Refund expired |