Query request status

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


KeyValue TypeRequiredDescription
service_codeStringYesThe merchant's service code.
merchant_transaction_idStringYesUnique transaction ID identifying the transaction as given by the merchant.

Response Status Codes

Status CodeDescription
200Success. Checkout request successfully logged in the checkout platform.
500Failure. Generic failure occurred. Could be as a result of a system failure on the checkout platform.
1001No request found.
1007Missing country code. The checkout request posted was missing a country_code
1013Not JSON. The checkout request posted was not valid JSON
1014Missing merchant transaction id. The request did not have a merchant_transaction_id
1015Missing checkout request id.The request did not have a checkout_request_id
1017Invalid charge msisdn provided. The charge_msisdn provided was not valid in the country provided
1027Invalid amount provided. The charge_amount should be between the minimum and maximum amounts provided for the payment option.
Click Try It! to start a request and see the response here!