The Programmable Service API uses standard HTTP error reporting. Successful requests return HTTP status codes in the 2xx. Failed requests return status codes in 4xx and 5xx. Response codes are included in the JSON response body, which contain information about the response.

Response CodeDescriptionAction Required
0000The transaction has been processed successfully.None.
0001API is not available.Ensure you are providing the correct Basic Auth key for the Authorization header.
4105Authenticated Hubtel organization not owner of specified account number.There is a mismatch between the Merchant Account number (POS SALES ID) and the Basic Auth key. Ensure your API keys are from the same Hubtel account.