Are you looking for test card numbers?

Would you like to contact support?

Developer-resource icon

Changes to errors in API responses

We're changing some of our error codes and messages on March 29, 2022.

On March 29, 2022, we will update some error codes and messages returned in API responses to provide more specific information about the errors. This update will affect values returned in the errorCode and message fields.

If your integration uses the error codes and messages on this page, verify the changes and update your implementation to ensure that your error handling flows keep working as expected.

The changes will include:

  • Adding more granular error codes.
  • Deprecating existing error codes in favor of the new, more granular error codes.
  • Updating error messages.

The changes will apply to the following error codes:

000 - Multiple messages

The 000 error code is a generic error code that comes with different messages.

If you're using the old error code and messages below in your integration, make sure to update to the new error codes and messages.

Old error code and message New error code and message
000 - No amount specified 100 - Required object 'amount' is not provided.
000 - Missing required field shopperEmail 120 - Required field 'shopperEmail' is not provided.
000 - shopperReference is empty 121 - Required field 'shopperReference' is not provided.
000 - Recurring requires shopperReference 121 - Required field 'shopperReference' is not provided.
000 - Invalid currency specified 138 - Field 'currency' is not valid, reason: The provided currency is not supported.
000 - No InitialPspReference provided 158 - Required field 'initialPspReference' is not provided.
000 - ownerName is empty 158 - Required field 'ownerName' is not provided.
000 - Please supply an orderReference 158 - Required field 'orderReference' is not provided.
000 - Please supply a reference 158 - Required field 'reference' is not provided.
000 - Invalid Request: Payment inquiries require a (merchant) reference! 158 - Required field 'reference' is not provided.
000 - Invalid shopperInteraction provided 192 - Field 'shopperInteraction' is not valid.
000 - No billing address provided 194 - Required object 'billingAddress' is not provided.
000 - Invalid shopper interaction 217 - Field 'shopperInteraction' is missing or not valid.
000 - Lookup failed 218 - Recurring shopper lookup failed.
000 - FraudOffset is out-of-range 29_003 - Field 'fraudOffset' must be between -999 and 999.
000 - CVC is required for OneClick card payments 820 - CVC is required for OneClick card payments.
000 - No card object set 918 - Required object 'card' is not provided.
000 - Payment method extra costs should be in same currency as payment 919 - The 'additionalAmount' currency should be the same currency as the payment.
000 - Total payment amount should be equal or greater than zero 920 - Total payment amount should be equal or greater than zero.
000 - MpiData missing, required due to threeDReference 921_1 - Object 'mpiData' is missing, required due to threeDReference.
000 - Invalid MPIData, AuthenticationResponse missing 921_2 - Object 'mpiData' is not valid. Reason: 'authenticationResponse' missing.
000 - Invalid MPIData, directoryResponse mismatch 921_2 - Object 'mpiData' is not valid. Reason: 'directoryResponse' mismatch.
000 - Account updater connection only supported for visa & mastercard 922 - Account updater connection only supported for Visa & MasterCard.
000 - No registered account for AccountUpdater 923 - No registered account for AccountUpdater.
000 - Not allowed to change the shopperInteraction 924 - Not allowed to change the shopperInteraction.
000 - Invalid iDEAL issuer provided 926 - Invalid iDEAL issuer provided.
000 - Please supply paymentDetails 927 - Missing payment details.
000 - Invalid forex type specified 928 - Invalid forex type specified.
000 - Invalid base currency specified 929 - Invalid base currency specified.
000 - Unknown target currency 930 - Invalid target currency specified.
000 - There is no merchant with the code {0} 931 - There is no merchant with the code {0}.

14_021 - Unknown terminal

The 14_021 error code will be deprecated and replaced with the following error codes and messages. Error codes with a 14_ prefix are only returned in Checkout API.

Old error code and message New error code and message
14_021 - Unknown terminal: {0} 14_0425 - Terminal with uniqueTerminalId '{0}' was not found.
14_0426 - Terminal with uniqueTerminalId '{0}' is not deployed.
14_0427 - Insufficient permissions for terminal with uniqueTerminalId '{0}'.
14_0430 - Provided merchant unknown.
14_0431 - Unknown terminal.
14_0432 - Unknown terminal.

701 - server could not process request

The 701 error code will be broken down into more granular errors but 701 remains as a general error code if the new error code does not apply.

Old error code and message New error code and message
701 - server could not process request 701 - server could not process request.

This remains as a general error code.
14_0428 - Merchant account is missing Pay by Link permission(s).

702 - Problem parsing request

The 702 error code will be broken down into more granular errors but 702 remains as a general error code if the new error code does not apply.

Old error code and message New error code and message
702 - Problem parsing request 702 - Problem parsing request

This remains as a general error code.
158 - Required field '{0}' is not provided.

905 - Payment details are not supported

The 905 error code will be broken down into more granular errors but 905 remains as a general error code if the new error codes do not apply.

Old error code and message New error code and message
905 - Payment details are not supported 905 - Payment details are not supported

This remains as a general error code.
905_1 - Could not find an acquirer account for the provided txvariant ({0}), currency ({1}), and action ({2}).
905_2 - No specified acquirer account found for '{0}' for specified acquirer '{1}' with variant '{2}' for unit '{3}' for Action '{4}'
905_3 - Could not find an acquirer account for the provided currency ({0}).
905_4 - Cashback and Cashout are not allowed for the configured acquirer account.
905_5 - No acquirer account active and configured for Klarna.
905_6 - Both 'KlarnaPayments' and 'Klarna' platforms have been configured for the merchant account. Only one of two is allowed.