Error Codes

Below is a list of possible error codes for iOS, along with a short description.

Payment params errors:

1000: Unsupported transaction payment params.
1010: Transaction checkout ID is not valid.
1010: Checkout Id is nil.
1011: Invalid server response: Afterpay extra params missing.
1011: Invalid server response: Clearpay extra params missing.
1011: Invalid server response: Klarna Inline extra params missing.
1011: Invalid server response: Cash App Pay extra params missing.
1011: Invalid server response: Amazon Pay extra params missing.
1012: Device authentication check failed.
1090: The token identifier is invalid. Must be alpha-numeric string of length 32.
1091: Tokenization is not supported for chosen payment brand.
1163: The national identifier is not valid.
1170: The account verification is not valid.
1180: The payment token is invalid. To perform this type of transaction a valid payment token is needed.

Card errors:

1110: Holder must at least contain first and last name.
1111: Invalid card number. Does not pass the Luhn check.
1112: Unsupported card brand.
1113: Month must be in the format MM.
1114: Year must be in the format YYYY.
1115: Card is expired.
1116: CVV invalid. Must be three or four digits.

Bank account errors:

1130: Holder of the bank account is not valid.
1131: IBAN is not valid.
1132: The country code of the bank is invalid. Should match ISO 3166-1 two-letter standard.
1133: The name of the bank which holds the account is invalid.
1134: The BIC (Bank Identifier Code (SWIFT)) number of the bank account is invalid.
1135: The code associated with the bank account is invalid.
1136: The account number of the bank account is invalid.
1137: Routing number of the bank account is not valid.

Transaction errors:

2000: Checkout info cannot be loaded.
2001: There are no available payment methods in the checkout.
2002: Payment method is not available.
2002: Klarna mobile SDK is not available.
2003: The transaction was aborted.
2004: No available brands to validate.
2005: Checkout data cannot be loaded.
2010: The transaction was declined. Please contact the system administrator of the merchant server to get the reason of failure.
2020: Apple Pay request is not correctly configured.
2020: The scheme or shopperResult URL is required for Klarna Payments proper configuration.
2020: is not supported for Klarna payment brand. Supported countries:

Request errors:

3000: Connection Failed.
3001: No payment brands specified for the logo request.
3001: Empty bin provided.
3002: Invalid response from the Server.
3002: Invalid response from bin service.
3002: Invalid server response for logo request.
3002: Invalid response from ideal servers service.

Security errors:

4000: File loaded from resources does not have valid checksum. Make sure you installed the framework correctly and no one has been tampering with the application.

Apple Pay errors:

1150: The Apple Pay payment token data is invalid. To perform this type of transaction a valid payment token data is needed.
1151: The Apple Pay authorization has been declined.
1152: Failed to submit apple pay request.
1153: Invalid server response: ApplePay recurring params missing.

Klarna Payments errors:

5001: Internal Klarna Payments error.

Bancontact Link errors:

5002: Invalid server response: Bancontact link app scheme URL missing.

Vipps errors:

5003: Vipps specific error.

Afterpay errors:

5004: No Afterpay Config provided.

Clearpay errors:

5005: No Clearpay Config provided.

Blik errors:

5006: Blik specific error.

Cash App Pay errors:

5007: No CashAppPay Config provided.

Affirm Payments errors:

5008: Affirm Payments specific error.

AmazonPay errors:

5009: No AmazonPay Config provided.

MobilePay errors:

5010: MobilePay specific error.

3-D Secure 2 errors:

6000: 3-D Secure 2 transaction error.
6000: Callback url not found.
6000: Invalid 3-D Secure 2 authentication response.
6000: The challenge was timed out.
6000: Error in challenge flow.
6000: ThreeDS2 Web Flow rediract url is missing.
6000: Navigation controller is required to process 3-D Secure 2 challenge.
6001: The challenge was canceled.

Credit card number scanning error:

7000: Card Scanning view controller supported on iOS 13 and up.

Copy and Pay web loading error:

8000: Copy and Pay general error.

Custom Components general error:

9000: Custom component general error.

Below is a list of possible error codes for Android, along with a short description.

Payment params errors:

1000: The payment params are not valid.
1000: Brand Name is missing.
1010: The payment scheme is not valid.
1010: The checkout ID is not valid.
1010: The payment brand is null.
1011: The payment scheme is not valid.
1011: The payment brand is null.
1011: Missing payment brand for Klarna inline flow.
1090: The provided token is not valid.
1161: The country code is not valid.
1163: The national identifier is not valid.
1170: The account verification is not valid.
1180: The payment token is missing.

Card errors:

1110: The card holder is not valid.
1111: The card number is not valid.
1113: The card expiry month is not valid.
1114: The card expiry year is not valid.
1115: The card is expired.
1116: The card cvv is not valid.

Bank account errors:

1130: The account holder is not valid.
1131: The IBAN is not valid.
1132: The SOFORT country is not valid.
1133: The bank name is not valid
1134: The Account number is not valid.
1135: The Bic is not valid.
1136: The Bank code is not valid.
1137: The Routing number is not valid.
1161: The country code is not valid.

Transaction errors:

2001: CheckoutInfo is null.
2001: BrandsValidation is null.
2001: Endpoint can't be null.
2001: Transaction is null.
2001: Redirect URL is null or empty.
2001: The ipworks3ds library is required for 3-D Secure 2 card transaction with APP flow.
4000: There are no available payment methods in checkout.
4001: Payment method is not available.
4001: The play-services-wallet library is not available.
4001: The shopperResult URL is required for Klarna Payments proper configuration.
4002: CheckoutSettings is null.
4003: Transaction was aborted.
4004: Unexpected exception is thrown. See stack trace in getErrorInfo().
4004: ActivityResultLauncher is null.
4004: This can only be invoked for CashAppPay.
4005: No object returned during onBeforeSubmit.
4006: Transaction state is unknown, request payment status to get the actual state.

Request errors:

3000: Unexpected connection error.
3100: Malformed server response.
3001: Invalid input parameters for the request.
3002: Invalid response from the Server.

Google Pay errors:

1000: Google Pay card brand is missing.
1000: Not a Google Pay or Google Pay Token brand.
5000: The Google Pay payment token data is invalid.
5000: Payment data request is invalid.
5000: Google Pay payment data is empty.
5000: GooglePayPaymentDataRequestJson is not set.
5000: Google Pay payment token is null in json response.
5000: Failed to parse Google Pay response json.

Klarna Payments errors:

1010: Missing payment brand for Klarna inline flow.
2001: Klarna inline payments params are invalid.
2001: Klarna inline fragment is null.
4001: Klarna country is not supported.
5001: Klarna Payments specific errors....
5001: Error sending request to callbackUrl/failureCallbackUrl.

Bancontact Link errors:

5002: Bancontact Link specific error.
5002: Bancontact Link app is not installed.
5002: Bancontact Link app scheme URL is missing.

Afterpay errors:

5004: Afterpay specific error.

Samsung Pay errors:

4001: Samsung Pay SDK is not available.
5005: Samsung Pay specific error.

Blik errors:

5006: Blik specific error.

Cash App Pay errors:

5007: Cash App Pay specific error.

Affirm Payments errors:

2001: Affirm config is invalid.
5008: Affirm Payments specific error.

AmazonPay errors:

5009: AmazonPay specific error.

3-D Secure 2 errors:

6000: 3-D Secure 2 transaction error.
6001: 3-D Secure 2 transaction was cancelled.
6001: 3-D Secure 2 transaction timed out.

UI errors:

7000: Missing iban.
7000: Missing account holder.
7000: Missing card number.
7000: Missing payment methods.