---
id: error-codes
title: Error codes
hide_title: true
description: "Common error codes from the Walley Checkout API"
---

import Ingress from '../../src/components/ingress/ingress.react';

<Ingress title="Error codes">
  When consuming the Checkout API, the following error codes can occur and should be handled according to the instructions
</Ingress>

Codes 400 to 503 are standard HTTP status codes. Code 900 is a Walley-specific status code for business errors, outside the standard HTTP range. Every code is also returned in the `error.code` property of the response body, with the specific cause in `error.errors[].reason`.

| Error code | Meaning                                                                                            | Action                                                       |
| ---------- | :------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| 400       | Bad or faulty request. Please examine the errors property for details.                              | Check your request                                           |
| 401       | The resource requested requires authentication.                                                     | Check your authentication                                    |
| 403       | Access to the requested resource is denied.                                                         | Check that you are using the correct credentials and StoreId |
| 404       | The resource requested was not found.                                                               | See if your are using the correct route and base URL         |
| 409       | The request could not be completed due to a conflict with the current state of the target resource. | Implement retry logic                                        |
| 423       | The resource requested is currently locked for modification. Try again.                             | Implement retry logic                                        |
| 500       | An unhandled exception has occurred. Please contact Walley!                                          | Contact Walley                                               |
| 503       | Service unavailable.                                                                                | Contact Walley                                               |
| 900       | The request was rejected by the server due to a business error.                                     | Business error. See details in response to take action       |
