> For the complete documentation index, see [llms.txt](https://docs.maibmerchants.md/request-to-pay/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/request-to-pay/api-reference/errors/api-errors.md).

# API Errors

Here are listed the API status codes indicating that an error occurred while making a request to the RTP API, along with possible solutions. If you encounter errors or uncertainties during integration or testing, please consult the API documentation and, if needed, contact the technical support team. For efficient analysis, please provide the following details:

* HTTP status code
* `errorCode`
* `errorMessage`
* Exact date and time of the request
* Information about the integrated solution (Project ID, Merchant name, Application/Website name, Website URL)

***

**Error format**

All error responses follow a consistent JSON schema:

```json
[
  {
    "errorCode": "string",
    "errorMessage": "string",
    "errorArgs": {
      "additionalProp1": "string",
      "additionalProp2": "string",
      "additionalProp3": "string"
    }
  }
]
```

* **errorCode** — machine-readable code.
* **errorMessage** — human-readable explanation.
* **errorArgs** — optional additional parameters.

***

### API Errors

| Error Code         | HTTP Status | Message (EN)                                                                           |
| ------------------ | ----------- | -------------------------------------------------------------------------------------- |
| **common.error-1** | 500         | Oops! An error occurred in the system. Call 1313.                                      |
| **10000**          | 500         | Internal error encountered. Please try again or report if error persists.              |
| **11000**          | 401         | Invalid credentials. Please check `clientId` and `clientSecret`.                       |
| **12000**          | 400         | Parameter `{{parameter}}` is invalid.                                                  |
| **12001**          | 400         | Provided request is invalid: `{{error}}`.                                              |
| **12003**          | 400         | Sorting options are invalid.                                                           |
| **12006**          | 400         | `expiresAt` field must be in the future. Provided value: `{{actualValue}}`.            |
| **14009**          | 409         | Account is not active.                                                                 |
| **22000**          | 400         | The selected currency is invalid. Please review and try again.                         |
| **22001**          | 400         | The selected request status is invalid. Please verify your filter.                     |
| **22002**          | 400         | Sorting options are not valid. Please adjust and try again.                            |
| **23000**          | 404         | The specified Request to Pay does not exist or has expired.                            |
| **24000**          | 409         | This merchant is not currently active. Please contact support.                         |
| **24001**          | 409         | This account is not active. Please use another account or contact us.                  |
| **24002**          | 409         | Only MDL currency accounts are accepted for Request to Pay.                            |
| **24003**          | 409         | Operation cannot be completed with the selected account.                               |
| **24004**          | 409         | This request cannot be processed due to incomplete setup. Please contact maib support. |
| **24005**          | 409         | The current status does not permit the operation to be processed.                      |
| **24006**          | 409         | The recipient has not activated MIA. Please verify or use another payment method.      |
| **34001**          | 409         | Partial refund is not available: `{paymentId}`.                                        |

***

### Example Error Response

```json
[
  {
    "errorCode": "23000",
    "errorMessage": "The specified Request to Pay does not exist or has expired."
  }
]
```