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:

[
  {
    "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

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