Mobile SDK error codes

Use the following error codes to troubleshoot issues in Mobile SDK integrations.

iOS

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

Payment parameter 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.

Visa Installment errors

  • 5011: Visa Installment 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.

Android

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

Payment parameter 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.

Samsung Pay errors

  • 4001: Samsung Pay SDK is not available.
  • 5005: Samsung Pay 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.