API responses may return following codes and messages in case of any errors.
These messages are not meant to be displayed to the end user, as most of them are of very technical nature.
Instead, the Merchant’s system or shop should decide what to do in each of these cases (for instance, suggesting a new payment method when the risk check fails). We suggest to show the user the generic error message, and use these codes in your logs for further analysis.
Error codes not displayed here are either deprecated or not relevant. In case of any doubts, contact us.
Code | Message | Meaning | Action |
---|---|---|---|
101 | Merchant not found. | The Merchant does not exist or was not recognized. | Check the API key. |
102 | Transaction not found. | Transaction does not exist. Rare; may occur when redirecting back from the acquirer. | Try again later or contact us. |
104 | Unsupported payment type. | Payment method does not exist or merchant does not have this payment method configured. | Find your payment method from list in Appendix or contact us for setting up required payment method. |
106 | The payment processor is not responding. | Acquirer is not responding. | Try again later. |
107 | There has been an error with the payment processor. | Acquirer service is not responding or returning errors. | Try again later or contact us. |
108 | Payment error | Acquirer returned a payment-related error.Includes more information in the message if available. | Look into error message and contact us if required. |
109 | Merchant does not have payment processor for this payment type. | No acquirer has been defined for the merchant. | Contact us. |
110 | Customer did not agree to the risk check process required by this payment method. | Customer must explicitly agree to the risk check process. | Check risk_check_approval. Remind the customer that risk check must be approved. |
111 | Risk check processor not found. | System error | We probably already noticed this error and working on it. Contact us if necessary. |
112 | Customer did not pass the risk check. | Customer had insufficient risk check score, wasn’t identified by the risk check service or the address does not exist. | Inform the customer and suggest alternative payment methods. |
113 | There has been an error with the risk check. | Error in the risk check processor’s service. | Try again later. |
114 | Too many risk check attempts from this address. | Customer from the same IP has attempted to submit an order (and failed the risk check) multiple times, possibly with different personal/address data. | .Suggest an alternative payment method. |
115 | Payment provider not found. | System error. | We probably already noticed this error and working on it. Contact us if necessary. |
116 | Risk check adapter not found. | System error. | We probably already noticed this error and working on it. Contact us if necessary. |
117 | Payment adapter not found. | System error. | We probably already noticed this error and working on it. Contact us if necessary. |
118 | Recurring payment could not find the original transaction. | You are trying to run a recurring transaction, but the original transaction was not found. | Provide or check original_transaction_id's validity. |
119 | This payment processor does not support recurring payments. | You are trying to make a recurring payment with an acquirer that doesn’t support recurring payments. | Make a new non-recurring payment. |
120 | Recurring payment could not find the original payment token. | The tokens needed to make a repeat transaction with the acquirer could not be found. Most likely the acquirer did not support recurring payments at the time of the original transaction. | Make a new non-recurring transaction. |
121 | This payment processor does not support refunds. | Refunds cannot be made for this acquirer. | Contact us if the transaction MUST be refunded. |
122 | The refunded amount cannot exceed the original amount. | Combined amount of past refunds for this transaction is larger than the original amount. | Check the amount to be refunded. |
123 | This currency is not supported. | The selected currency is not supported by this acquirer. | Make sure provided currency code is valid and try another currency otherwise. |
124 | Invalid country code. | The country has not been specified in the correct format. | Make sure the country code is in the ISO 3166-1 format. |
125 | Invalid or missing return URLs. | No valid return URLs have been specified in the payment request. | Check the parameters success_url, error_url and postback_url. |
126 | Invalid bank account information. | The bank data of a direct debit transaction does not pass the validation. | Check IBAN and BIC |
127 | This payment processor does not support authorization. | The payment processor does not support authorize/capture/reverse operations. | Do not use Authorization API or contact us. |
128 | Transaction has not been authorized for capture or reverse operation. | The status of transaction is other than “authorized”, that is, it has already been captured or reversed or was not authorized to begin with. | Create a new payment. |
134 | Amount cannot be zero or negative. | Payments with zero or negative amounts are rejected by all acquirers. | Only send payments with an amount greater than zero. |
135 | Payouts not supported. | Payment processor does not support payouts. | Make sure the payment processor you are using supports payouts. |
136 | Transaction status change not possible. | The status change is not permitted or logical, for example trying to change a cancelled transaction to completed. | Try another status or contact us. |
144 | Unauthorized. | The passed credentials are invalid. | Check your api_key and outgoing_key |
145 | Channel cannot be found. | Provided url_name does not match to any active channels. Relevant to C-Pay now product only(a.k.a Jetztzahlen). | Check url_name of the channel you would like to manage. |
146 | Import error: related error message. | Import error will describe any validations that the request could not pass. Relevant to C-Pay now product only(a.k.a Jetztzahlen). | Check the imports page of the C-Pay now channel. |