> For the complete documentation index, see [llms.txt](https://docs.maibmerchants.md/e-commerce/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maibmerchants.md/e-commerce/errors/http-status-codes.md).

# HTTP status codes

{% hint style="info" %}
If you encounter errors or uncertainties during integration/testing, please consult the API documentation in more detail or contact the [support team](mailto:ecom@maib.md), providing as much error-related data (HTTP status code, errorCode, errorMessage, date/time of the request) and information regarding the e-commerce solution (Project ID, Merchant name, website/app name, website URL).
{% endhint %}

<table><thead><tr><th width="144">Error code</th><th width="157">Error message</th><th>Description</th><th>Solution</th></tr></thead><tbody><tr><td>400 </td><td>Bad Request</td><td><p>The request is not understood by the server <strong>maib ecomm</strong> due to incorrect syntax.</p><p>This means that the <strong>maib ecomm</strong> system was unable to understand the request and process it because the request sent by the client was not formed properly.</p></td><td><p>Check parameter names and value types.</p><p>Make sure that you are not missing the mandatory parameter.</p><p></p><p>Please, make sure that all the parameters and values are passed correctly before repeating the request.</p></td></tr><tr><td>401</td><td>Unauthorized</td><td>This status code means that the user authentication is required by the <strong>maib ecomm</strong> system or that authorization for the provided credentials was refused - this might mean that one or both of your credentials are invalid.</td><td><p>Make sure your credentials are correct (<em>Project ID/Project Secret</em>).</p><p>Ensure that a valid Access Token is passed and is not expired.</p></td></tr><tr><td>403</td><td>Forbidden</td><td>The <strong>maib ecomm</strong> system refuses to connect because requests from this IP are not allowed.</td><td>Make sure you are registered with <strong>maibmerchants</strong> and there is an active Project with the IP you are requesting from.</td></tr><tr><td>404</td><td>Not Found</td><td><p>The server responds with this error when it understands the HTTP request sent by the caller but cannot find requested resources for the given URL.</p><p>No indication is given in the server response if the resource is not available temporarily or permanently.</p></td><td>Make sure the URL is correct and the resource id (e.g., <em>payId/billerId</em>) specified in the path is correct.</td></tr><tr><td>415</td><td>Unsupported Media Type</td><td>The <strong>maib ecomm</strong> is refusing to service the request because the entity of the request is in a format not supported by the requested resource for the requested method.</td><td><p>Make sure that the requested body is in the correct format.</p><p></p><p>Make sure that the Content-Type header exists and has the correct value. (<em>application/json</em>).</p></td></tr><tr><td>429</td><td>Too Many Requests</td><td><p>This status code notifies that too many requests were made by the caller in a predefined time period.</p><p>This mechanism throttles the number of requests for protecting against performance lags and downtime.</p></td><td>Check your codebase whether you need so many requests per period. If it's necessary, contact the <strong>maib</strong> ecommerce support team to configure different policies for your application.</td></tr><tr><td>500</td><td>Internal Server Error</td><td>The <strong>maib ecomm</strong> system responds with this status code when it has encountered an unexpected condition, which prevented it from fulfilling the request.</td><td>There is problem-related to the <strong>maib ecomm</strong>, you should contact  <strong>maib</strong> ecommerce support team for more information or assistance.</td></tr><tr><td>503</td><td>Service Unavailable</td><td><p>The <strong>maib ecomm</strong> system responds with this status code when it is currently unable to handle the request due to a temporary overloading or maintenance of the server. This is a temporary condition, which will be alleviated after some delay. </p><p><br></p><p>If this period is expected to be longer, then Merchants will be notified in advance in <strong>maibmerchants</strong> and by email.</p></td><td><p>Repeat the request after a short period of time.</p><p></p><p>If the error is repeated for a longer time, contact the <strong>maib</strong> ecommerce support team.</p></td></tr></tbody></table>