HTTP Status codes & descriptions

Interswitch's APIs are Restful and as such follow standard HTTP response codes for successful or failed transactions.

ErrorDescription
200, 201, or 202This means the request was successful and the action has been carried out. Also note, we will always send a 200,201 or 202 if the intended action is accepted, completed or verified.
400A validation error occurred, the request was not completed. This means a parameter to complete this request is unavailable or invalid in the request payload. Kindly check and try again.
401This can be triggered by passing an invalid secret key in the authorization header or in a scenario where there is none. The request will not be authorized as your request does not fulfill the basic requirement for a successful API call.
404In essence, your request could not be fulfilled as the resource/institution requested does not exist. Please validate the resource requested in this case as this should not happen.
500, 501,502,503,504This request could not be completed due to an error at Interswitch's end. Ordinarily, this should not happen however please, report if you encounter any instance of this kind.