API Errors

This section lists the API status codes and error responses that may occur when interacting with the Checkout API. Each error entry includes its meaning and suggested resolution.

If you encounter unexpected errors during integration or testing, please:

• Review the API documentation

• Validate the request payload and headers

• If needed, contact the technical support team

When reporting an issue for analysis, please include:

• HTTP status code

• errorCode

• errorMessage

• Exact date and time of the request

• Integration details (Project ID, Merchant name, Application or Website name, Website URL)

---

Error Format

All API error responses follow a consistent JSON schema:

{
  "ok": false,
  "errors": [
    {
      "errorCode": "string",
      "errorMessage": "string",
      "errorArgs": {
        "additionalProp1": "string",
        "additionalProp2": "string",
        "additionalProp3": "string"
      }
    }
  ]
}

• errorCode — machine-readable unique code.

• errorMessage — human-readable explanation of the issue.

• errorArgs — optional context values for debugging or correlation.

---

Example Error Response

{
  "ok": false,
  "errors": [
    {
      "errorCode": "maib.merchant.payments-43001",
      "errorMessage": "The specified checkout does not exist or has expired."
    }
  ]
}

---

API Error Catalogue (Checkout API)

Error Code	Description	HTTP
maib.merchant.payments-42000	The selected currency is invalid. Please review and try again.	400
maib.merchant.payments-42001	Amount must be greater than zero.	🟠 400
maib.merchant.payments-42002	Amount must be greater than or equal to zero.	400
maib.merchant.payments-42003	Quantity must be greater than zero.	400
maib.merchant.payments-42004	Language is not supported. Supported languages: RO, RU, EN.	400
maib.merchant.payments-42005	Field has invalid format.	400
maib.merchant.payments-42006	A required field is missing.	400
maib.merchant.payments-42007	The pagination options are invalid.	400
maib.merchant.payments-43000	The specified merchant does not exist.	404
maib.merchant.payments-43001	The specified checkout does not exist or has expired.	404
maib.merchant.payments-44000	This merchant is not currently active. Please contact support.	409
maib.merchant.payments-44001	No payment methods are available for this checkout.	409
maib.merchant.payments-44002	The current status does not permit the operation to be processed.	409
maib.merchant.payments-44003	The payment profile is misconfigured. Please contact support.	409
common.error-1	An unexpected error occurred. Please try again later.	500

---

Handling Recommendations

• 400 (Bad Request): Verify all request parameters and value formats.

• 404 (Not Found): The resource is missing or expired — recreate or refresh the checkout.

• 409 (Conflict): The request is not allowed in the current state — check status and retry appropriately.

• 500 (Internal Server Error): Retry later or contact support with request details.