API errors

Here are listed all possible errors that can be received in response during requests to the maib e-commerce API.

If you encounter errors or uncertainties during integration/testing, please consult the API documentation in more detail or contact the support team, providing as much error-related data (HTTP status code, errorCode, errorMessage, date/time of the request) and information regarding the e-commerce solution (Project ID, Merchant name, website/app name, website URL).

Error format

{
  "errors": [
    {
      "errorCode": "10000",
      "errorMessage": "Error description {{erroArg}}",
      "errorArgs": {
        "errorArg": "Dynamic part of the error description"
      }
    }
  ],
  "ok": false
}

Errors table

Error Code	Error Message	Error Arguments	HTTP Status Code
10000	Internal error encountered. Please try again or report if error persists		500
11001	Invalid credentials. Please check 'projectId' and 'projectSecret' parameters		401
11002	Please provide 'projectId' and 'projectSecret' credentials or 'refreshToken'		401
11101	Unregistered Project IP: {{ip}}	ip	403
12001	Parameter '{{parameter}}' is invalid	parameter	400
12002	Provided request is invalid: {{error}}	error	400
12004	Parameter 'language' must have {{length}} characters	parameter length	400
12005	Parameter 'currency' is invalid. Possible values: {{values}}	parameter values	400
12006	Parameter 'phone' must not exceed {{maxLength}} characters	parameter maxLength	400
12007	Parameter 'email' must not exceed {{maxLength}} characters	parameter maxLength	400
12008	Parameter 'email' has invalid format	parameter	400
12011	Parameter 'payId' is required	parameter	400
12012	Parameter 'confirmAmount' must be in range from {{minValue}} to {{maxValue}}	parameter minValue maxValue	400
12013	Parameter 'confirmAmount' must have no more than {{maxScale}} decimal places	parameter maxScale	400
12014	Parameter 'amount' must be in range from {{minValue}} to {{maxValue}}	parameter minValue maxValue	400
12015	Parameter 'amount must have no more than {{maxScale}} decimal places	parameter maxScale	400
12016	Parameter 'delivery' must be in range from {{minValue}} to {{maxValue}}	parameter minValue maxValue	400
12017	Parameter 'delivery' must have no more than {{maxScale}} decimal places	parameter maxScale	400
12018	Parameter 'clientIp' is required	parameter	400
12019	Parameter 'clientIp' has invalid format. Only IPv4 is allowed	parameter	400
12020	Parameter 'description' must not exceed {{maxLength}} characters	parameter maxLength	400
12021	Parameter 'clientName' must not exceed {{maxLength}} characters	parameter maxLength	400
12022	Parameter 'okUrl' has invalid format	parameter	400
13023	Parameter 'failUrl' has invalid format	parameter	400
12024	Parameter 'callbackUrl' has invalid format	parameter	400
12025	Parameter 'orderId' must not exceed {{maxLength}} characters	parameter maxLength	400
12026	'items' array must not exceed {{maxCount}} elements	parameter maxCount	400
12028	Parameter 'refundAmount' must be in range from {{minValue}} to {{maxValue}}	parameter minValue maxValue	400
12029	Parameter 'refundAmount' must have no more than {{maxScale}} decimal places	parameter maxScale	400
12032	Parameter 'billerId' is required	parameter	400
12033	Parameter 'billerExpiry' is required	parameter	400
12034	Parameter 'billerExpiry' has invalid format. Valid format is 'MMYY'	parameter	400
12035	Parameter 'billerExpiry' must contain current or future date. Current date: {{currentDate}}	parameter currentDate	400
12036	Parameter 'items[{{itemIndex}}].id' must not exceed {{maxLength}} characters	parameter maxLength itemIndex	400
12037	Parameter 'items[{{itemIndex}}].name' must not exceed {{maxLength}} characters	parameter maxLength itemIndex	400
12038	Parameter 'items[{{itemIndex}}].price' must be in range from {{minValue}} to {{maxValue}}	parameter minValue maxValue itemIndex	400
12039	Parameter 'items[{{itemIndex}}].price' must have no more than {{maxScale}} decimal places	parameter maxScale itemIndex	400
12040	Parameter 'items[{{itemIndex}}].quantity' must be more than zero	parameter itemIndex	400
12041	Please provide 'projectId' and 'projectSecret' credentials or 'refreshToken'		400
13002	Payment ID '{{paymentId}}' not found	paymentId	404
13003	Biller ID '{{billerId}}' not found"	billerId	404
13101	Processing error: {{processingError}}	processingError	409
13102	Refund amount cannot be greater than {{amount}}	refundAmount amount	409
13103	Refund amount cannot be greater than {{confirmAmount}}	refundAmount confirmAmount	409
13004	Confirm amount cannot be greater than {{amount}}	confirmAmount amount	409
13106	Payment does not require completion		409
13107	OK URL is not set		409
13108	FAIL URL is not set		409
13109	CALLBACK URL is not set		409
13110	Partial refund is not supported for payments in Hold status		409
13111	Biller ID '{{billerId}}' is inactive	billerId	409
13112	Biller ID '{{billerId}}' is not allowed for this payment type	billerId	409
13113	{{paymentType}} payment type in {{currency}} currency is not allowed for this Project	paymentType currency	409
13114	Refund is not possible for payment with a zero amount		409
13115	Complete is supported only for payments in Hold status		409
13116	Payment is already refunded		409
13117	Refund is not allowed for payment in {{statusPay}} status	statusPay	409