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

# API Errors

Here are listed the HTTP status codes indicating that an error occurred while making a request to the QR MIA 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

```
{
  "errors": [
    {
      "errorCode": "14005",
      "errorMessage": "QR {{qrId}} is already cancelled.",
      "errorArgs": {
        "qrId": "123456789"
      }
    }
  ],
  "ok": false
}
```

#### API Errors

| Error Code | Error name                     | Message                                                                                                                    | Parameters         | HTTP Code |
| ---------- | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------- | ------------------ | --------- |
| `10000`    | `maib.merchant.payments-10000` | Internal error encountered. Please try again or report if error persists.                                                  | –                  | 500       |
| `11000`    | `maib.merchant.payments-11000` | Invalid credentials. Please check 'clientId' and 'clientSecret'.                                                           | –                  | 401       |
| `12000`    | `maib.merchant.payments-12000` | Parameter `{{parameter}}` is invalid.                                                                                      | `parameter`        | –         |
| `12001`    | `maib.merchant.payments-12001` | Provided request is invalid: `{{error}}`.                                                                                  | `error`            | –         |
| `12002`    | `maib.merchant.payments-12002` | Currency `{{currency}}` is invalid.                                                                                        | `currency`         | –         |
| `12003`    | `maib.merchant.payments-12003` | Sorting options are invalid.                                                                                               | –                  | –         |
| `12004`    | `maib.merchant.payments-12004` | QR type `{{actualValue}}` is invalid.                                                                                      | `actualValue`      | –         |
| `12005`    | `maib.merchant.payments-12005` | QR status `{{actualValue}}` is invalid.                                                                                    | `actualValue`      | –         |
| `12006`    | `maib.merchant.payments-12006` | 'expiresAt' field must be in future. Provided value: `{{actualValue}}`.                                                    | `actualValue`      | –         |
| `12007`    | `maib.merchant.payments-12007` | Please provide 'clientId' and 'clientSecret'.                                                                              | –                  | –         |
| `13000`    | `maib.merchant.payments-13000` | QR `{{qrId}}` is not found.                                                                                                | `qrId`             | 404       |
| `14000`    | `maib.merchant.payments-14000` | Merchant is not active.                                                                                                    | –                  | 409       |
| `14001`    | `maib.merchant.payments-14001` | 'expiresAt' field must be in future.                                                                                       | –                  | 409       |
| `14002`    | `maib.merchant.payments-14002` | MIA MCC is not set.                                                                                                        | –                  | 409       |
| `14003`    | `maib.merchant.payments-14003` | MIA payment `{{miaPaymentId}}` is not found.                                                                               | `miaPaymentId`     | 409       |
| `14004`    | `maib.merchant.payments-14004` | Merchant `{{merchantId}}` has no default MIA account set.                                                                  | `merchantId`       | 409       |
| `14005`    | `maib.merchant.payments-14005` | QR `{{qrId}}` is already cancelled.                                                                                        | `qrId`             | 409       |
| `14006`    | `maib.merchant.payments-14006` | QR code type `{{type}}` is invalid.                                                                                        | `type`             | 409       |
| `14007`    | `maib.merchant.payments-14007` | QR code with a Fixed amount type must have amount set.                                                                     | –                  | 409       |
| `14008`    | `maib.merchant.payments-14008` | QR code with a Controlled amount type must have min or max amount set.                                                     | –                  | 409       |
| `14009`    | `maib.merchant.payments-14009` | Account is not active.                                                                                                     | –                  | 409       |
| `14010`    | `maib.merchant.payments-14010` | MIA payment is not found by QR id `{{qrId}}`.                                                                              | `qrId`             | 404       |
| `14011`    | `maib.merchant.payments-14011` | MIA payment is not found by RRN `{{rrn}}`.                                                                                 | `rrn`              | 404       |
| `14012`    | `maib.merchant.payments-14012` | MIA payment is not found by MIA message id `{{miaMessageId}}`.                                                             | `miaMessageId`     | 404       |
| `14013`    | `maib.merchant.payments-14013` | Auto-refund is only allowed for dynamic QRs.                                                                               | –                  | 409       |
| `14014`    | `maib.merchant.payments-14014` | Only direct operations can be refunded.                                                                                    | –                  | 409       |
| `14015`    | `maib.merchant.payments-14015` | MIA payment `{{paymentId}}` is already refunded.                                                                           | `paymentId`        | 409       |
| `14016`    | `maib.merchant.payments-14016` | Cannot refund MIA payment for provided amount `{{refundableAmount}}`. Available refundable amount: `{{refundableAmount}}`. | `refundableAmount` | 404       |
| `14017`    | `maib.merchant.payments-14017` | Cannot determine MIA commission percent for MCC `{mcc}`.                                                                   | `mcc`              | 404       |
| `14018`    | `maib.merchant.payments-14018` | Merchant not found by Account Number `{accountNumber}`.                                                                    | `accountNumber`    | 404       |
| `14019`    | `maib.merchant.payments-14019` | QR code's state does not allow this operation: `{state}`.                                                                  | `state`            | 409       |