Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.m4psp.com/llms.txt

Use this file to discover all available pages before exploring further.

​
List of possible M4 API errors

You can use this data to control the logic of your application, analyze and solve problems, output messages to the user, and for any other purpose. For example, if you received error_code: 11 in the response, then most likely you incorrectly specified the value of the shop_id parameter in the request body. If you receive result: false in the response, this means that an error occurred, and the transaction was either not created ( for example, in case of request body validation error), or ended with an error (for example, the payment system returned an error when trying to perform a transaction). If the error code is not fatal, then you need to wait for the server notification (applies to invoice or refund transactions) or after a certain time start requesting the status of the transaction (applies to payout transactions) (for 2 hours at 30-second intervals). If the error code is fatal the communication with our API is over. If you receive result: true in response, it means that the transaction was created successfully. If the transaction status in the synchronous response is not final (or is absent for some types of transactions), then you need to wait for the server notification or after a certain time start requesting the status of the transaction (applies only to payout transactions). After receiving the final status of the transaction, the communication with our API is over.
Error codeDescriptionFatal
1Payway has not been found+
2Payway is not active+
3Payway is not available+
4The specified amount is too small (payway restriction)+
5The specified amount is too big (payway restriction)+
6A non-unique operation identifier has been transferred on the part of the shop+
7Operation has not been found+
8Operation is being processed+
9Insufficient balance+
10Invalid request parameters+
11Shop has not been found+
12Shop is not active+
13Account has not been found in M4 system+
14Account status does not allow operations+
15Request from the current IP has been rejected+
16Currency exchange rate has not been found+
17Invalid contract type for the shop+
18Invalid account type+
19Unable to perform operation for shop with the status of an aggregator+
20Invalid project ID+
21Project is inactive+
22Invalid shop currency+
23Account deposit limit exceeds+
24Invalid payee balance+
25Zero amount is specified+
26Amount is less than zero+
27Daily limit has been exceeded+
40Operation with specified BIN is restricted+
41Transaction to this payment instrument is forbidden+
100Operation has an invalid status+
101Unable to refund since the invoice has a status other than Success (4)+
102Refund amount exceeds the available refund amount+
103Transaction for this payment method is not supported+
104Cannot execute a refund because an incomplete refund already exists. Wait for the current refund to complete before creating a new one.+
1001Payment system is unable to process the request now. Please try again later.−
1002Payment system has returned the “Access error” status. Please contact the payment system for further information.+
1003Invalid request parameters. Please verify the accuracy of the payment details and retry the request later.+
1004The payment amount is less or greater than the allowed limit. Please ensure that the payment amount complies with the requirements of the payment system or bank.+
1005The transaction limit has been exceeded. Please contact bank or the payment system to get information about the reasons for reaching the transaction limit.+
1006The account was not found in the payment system. Please check the correctness of the entered data and retry the request.+
1007An error occurred in the payment system. Request the status of the transaction or wait for a server notification.−
1008Insufficient funds in the account to process the payment. Please ensure that there are sufficient funds in the account and retry the request.+
1009Insufficient identification status of the wallet+
1010The account is blocked. Request information about the reasons for the blockage and the actions required to unblock the account in the payment system or use an alternative account.+
1011Operation is forbidden by a payment system. Please contact the payment system for further information.+
1012Operation is rejected by payment system. Please contact the payment system for further information.+
1013Account is locked in payment system−
1014Incorrect data in request parameters−
1015Transaction lifetime was expired+
1016The operation has been declined by the payment system. The user has an unpaid transaction that needs to be either declined or completed.+
1017The specified currency for the operation is unavailable. Please contact the payment system for information on the available currencies.+
1018No suitable options were found for the transaction. Please try again later.+
1019The user did not confirm or cancel the operation. Please try again later.+
1020The transaction failed KYT verification.+
1100Invalid CVV/CVC code. Please verify the accuracy of the entered CVV/CVC code on the back of the credit card.+
1101Suspicion of fraudulent activity. Please contact the payment system or bank for further information.+
1102The operation has been rejected by the payment system. Please verify the accuracy of the payment details and retry the request later.+
1103The operation has been rejected by the bank. Please contact the bank to determine the reason for the rejection.+
1104The operation with this payment instrument is prohibited. Please contact bank or the payment system for information on the reasons for the prohibition.+
1105The card has expired. Please check the expiration date of the card provided during the payment. If the card has indeed expired, please use a card with a valid expiration date.+
1106Invalid card number. Please check the correctness of the entered number and retry the request.+
11073D-Secure authentication is required. Please contact the payment system or bank for additional information.+
1108The payment token has expired. Obtain a new token and retry the request.+
1109Transaction rejected by MPI. Please repeat the payment using another bank card.+
2000Another error+