---
title: "Error handling"
description: "Resolve errors on the mobile Android device."
url: "https://docs.adyen.com/point-of-sale/mobile-android/troubleshooting"
source_url: "https://docs.adyen.com/point-of-sale/mobile-android/troubleshooting.md"
canonical: "https://docs.adyen.com/point-of-sale/mobile-android/troubleshooting"
last_modified: "2026-06-01T15:33:14+02:00"
language: "en"
---

# Error handling

Resolve errors on the mobile Android device.

[View source](/point-of-sale/mobile-android/troubleshooting.md)

The Adyen payments platform performs regular checks to make sure that the mobile device that is used in a Mobile solution is secure.

If an issue is found during the security attestation process in an integration with the Android SDK, an error is shown on the mobile device. In many cases end users can resolve the issue themselves. The user needs to resolve the issue before trying to use the device again.

If an issue is found when using the Android Payments app, the error is shown on the mobile device or in the App link. The error usually needs to be fixed in the code.

## Error messages for the Android SDK

The following tables show the most common errors and how to handle them. You need to resolve the issue before trying to use the device again. Refer to the column **Internet needed to resolve** to learn if your integration needs internet connectivity to resolve the error.

| Error code                       | Description                                                        | Internet needed to resolve                                                                  | Required action                                                                                                                                                                                                                                                                                    |
| -------------------------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ANDROID\_NOT\_UPDATED            | Transaction canceled.                                              | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Update the SDK to the latest software version and try again.                                                                                                                                                                                                                                       |
| DEBUG\_ENABLED\_APK              | Transaction canceled.                                              | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | On the device, go to **Settings** > **System** > **Developer Options** and turn off **Developer Options**.                                                                                                                                                                                         |
| DEVELOPER\_OPTIONS\_ON           | Transaction canceled.                                              | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | On the device, got to **Settings** > **System** > **Developer Options** and turn off **Developer Options**<.In your Test integration this error only occurs for PIN transactions.                                                                                                                  |
| INVALID\_NYC1\_FIRMWARE\_VERSION | Card reader firmware version is invalid.                           | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Update the card reader to the latest software version and try again.                                                                                                                                                                                                                               |
| LOCAL\_TIME\_TAMPERING           | Transaction canceled. Unable to check the security requirements.   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | On the device, go to **Settings** > **System** > **Date and Time** and turn on **Automatic date and time**.                                                                                                                                                                                        |
| NON\_SELF\_RESOLVABLE            | Transaction canceled. Unable to check the security requirements.   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Contact our [Support Team](https://ca-test.adyen.com/ca/ca/contactUs/support.shtml?form=other) to resolve the issue.                                                                                                                                                                               |
| NO\_TOKEN                        | Cannot transact.                                                   | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Connect the device to a network so that the SDK can check the security requirements.                                                                                                                                                                                                               |
| SECURITY\_PATCH\_LEVEL\_OUTDATED | Transaction canceled.                                              | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Update the SDK to the latest software version and try again.                                                                                                                                                                                                                                       |
| SYSTEM\_CHANGE                   | Transaction canceled. Cannot transact due to system change.        | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | Connect the device to a network so that the SDK can check the security requirements.If the date/time of the device was changed, you must change it back to continue transacting. If the device was restarted, connect the device to a network so that the SDK can check the security requirements. |
| TOKEN\_EXPIRED\_S\&F             | Offline transaction window has expired.                            | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Connect the device to a network so that the SDK can check the security requirements.                                                                                                                                                                                                               |
| TRANSACTION\_LIMIT\_REACHED      | Transaction canceled. Store-and-Forward transaction limit reached. | ![-white\_check\_mark-](/user/data/smileys/emoji/white_check_mark.png "-white_check_mark-") | Connect the device to a network so that the SDK can forward stored transactions to Adyen.                                                                                                                                                                                                          |
| USB\_DEBUGGING\_ON               | Transaction canceled.                                              | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | On the device, go to **Settings** > **System** > **Developer Options** and turn off **Developer Options**.                                                                                                                                                                                         |
| WIFI\_DEBUGGING\_ON              | Transaction canceled.                                              | ![-x-](/user/data/smileys/emoji/x.png "-x-")                                                | On the device, go to **Settings** > **System** > **Developer Options** and turn off **Developer Options**.                                                                                                                                                                                         |

## Error messages for the Android Payments app

The following table shows errors, their potential causes, and how to handle them if you are using the Android Payments app for your Mobile solution. These issues are shown either in the UI or within the App Link.

| Error code                              | Error name                                                      | Error shown | Description                                                                                                                                                                                                                                                                                        |
| --------------------------------------- | --------------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 01\_001 02\_001 03\_001                 | No return URL No return URL found No return URL found           | UI          | The return URL field is empty or missing. Check and fix the return URL. This error can occur during the **onboarding check** (01\_001), during the **boarding** (02\_001), or **before the payment** (03\_001).                                                                                    |
| 01\_002 02\_002 03\_002                 | Return URL encoding error Invalid return URL Invalid return URL | UI          | The return URL that was used is either encoded incorrectly or not encoded at all. Check and fix the return URL. This error can occur during the **onboarding check** (01\_002), during the **boarding** (02\_002), or **before the payment** (03\_002).                                            |
| 01\_003                                 | Native library error                                            | App Link    | Possibly the boarding request token is incorrect. Restart the onboarding process.                                                                                                                                                                                                                  |
| 01\_004 02\_018                         | Installation ID error Installation ID error                     | App Link    | Possibly the SDK requirements are not matched. Make sure to check the SDK requirements. This error can occur during the **onboarding check** (01\_004) or during the **boarding** (02\_018).                                                                                                       |
| 01\_105 02\_020 03\_019 05\_005 05\_006 | Invalid return URL Error Invalid return URL Error Error         | UI          | The return URL is incorrect. Check and fix the return URL. This error can occur during the **onboarding check** (01\_005), during the **boarding** (02\_020), **before the payment** (03\_019), or **after the payment** (05\_005 and 05\_006).                                                    |
| 02\_003                                 | Backend error                                                   | App Link    | This error occurs from the backend. Make sure you have the right Payments app role or that your encryption passphrase is set correctly.                                                                                                                                                            |
| 02\_004                                 | Boarding token error                                            | App Link    | Possibly the boarding request token is incorrect when sending the boarding token in your App Link. Check and fix the boarding request token.                                                                                                                                                       |
| 02\_005                                 | Boarding token error                                            | App Link    | The boarding token that was used is either encoded incorrectly or not encoded at all. Make sure that the boarding token is encoded correctly.                                                                                                                                                      |
| 02\_006                                 | Boarding token error                                            | App Link    | This error occurs when our system receives a boarding token but is unable to properly deserialize it.                                                                                                                                                                                              |
| 02\_007                                 | Boarding token error                                            | App Link    | Possibly, during the onboarding process, the signature validation of the boarding token failed. Restart the onboarding process.                                                                                                                                                                    |
| 02\_008                                 | Boarding token error                                            | App Link    | Possibly the boarding token is expired. Restart the onboarding process.                                                                                                                                                                                                                            |
| 02\_009 03\_009                         | General error General error                                     | App Link    | This error can occur when our system encounters a network communication problem either during **boarding** (02\_009) or **before the payment** (03\_009). Check your network connection.                                                                                                           |
| 02\_010                                 | Installation ID mismatch                                        | App Link    | The boarding request token being used was issued for a different device than the device that is currently trying to use the token. Request a new boarding request token specifically for the current device.                                                                                       |
| 02\_011 02\_012 02\_013 02\_014 02\_016 | Invalid signature Invalid signature Local error Error Error     | App Link    | These errors can occur during the **boarding flow**. Restart the onboarding process.                                                                                                                                                                                                               |
| 02\_015                                 | Error                                                           | App Link    | This error occurs during the `getInstallationToken` API call. Restart the onboarding process.                                                                                                                                                                                                      |
| 02\_017                                 | App is already boarded                                          | App Link    | This error occurs if you send another boarding request when the app is already boarded.                                                                                                                                                                                                            |
| 02\_019                                 | Installation Token error                                        | App Link    | The host URL cannot be extracted from the installation token to construct the correct URL for the request.                                                                                                                                                                                         |
| 03\_003                                 | Decoding error                                                  | App Link    | The Terminal API request is either encoded incorrectly or not encoded at all.                                                                                                                                                                                                                      |
| 03\_004                                 | Empty request object                                            | App Link    | The request object cannot be empty. Make sure that your Terminal API request includes all required parameters and send it again.                                                                                                                                                                   |
| 03\_005                                 | Onboarding data not found                                       | App Link    | This error can occur if you try to make a payment without onboarding. Restart the onboarding process first, then make the payment again.                                                                                                                                                           |
| 03\_006                                 | API error                                                       | App Link    | This error can occur when you make a call to the [Payments app API](https://docs.adyen.com/api-explorer/payments-app/latest/overview). Check the path and request parameters and the destination URL.                                                                                              |
| 03\_007 03\_008                         | Configuration not found Configuration not found                 | App Link    | These errors can occur **before the payment** if there is no configuration object found.                                                                                                                                                                                                           |
| 03\_010                                 | Installation token not found                                    | App Link    | Your request to the [Payments app API](https://docs.adyen.com/api-explorer/payments-app/latest/overview) is missing the installation token.                                                                                                                                                        |
| 03\_012                                 | Error                                                           | App Link    | This error can occur when our system cannot verify your request. Restart the onboarding process.                                                                                                                                                                                                   |
| 03\_013                                 | Nexo request error                                              | App Link    | A security component of your Terminal API request could not be verified. Make sure that your encryption is correct and your Terminal API request includes all required parameters.                                                                                                                 |
| 03\_014 03\_015                         | Decryption error Decryption failed                              | App Link    | These errors can occur when our system receives an encrypted Terminal API request from your end, but is unable to decrypt it. Make sure that your encryption is correct and try again.                                                                                                             |
| 03\_016                                 | Load key error                                                  | App Link    | This error can occur **before the payment** when our system is unable to retrieve or generate the necessary encryption key.                                                                                                                                                                        |
| 03\_017                                 | Malformed transaction request                                   | App Link    | Possibly a required parameter is missing from your Terminal API request. Make sure that your Terminal API request is correct and includes all required parameters.                                                                                                                                 |
| 03\_018                                 | NFC error                                                       | App Link    | The NFC reader is disabled, or not supported on the mobile device. Make sure to use a mobile device with an [integrated NFC reader](/point-of-sale/ipp-mobile/#supported-device-types) and enable the NFC reader.                                                                                  |
| 03\_020 05\_007 05\_010                 | Local data error Local data error Error                         | App Link    | These errors can occur when our system tries to retrieve essential security credentials during **boarding** (03\_020), both **before and after the payment** (05\_007), or **after the payment** (05\_010). Restart the onboarding process. If this does not help, contact the Adyen Support team. |
| 03\_021 05\_008                         | Shared key not found Shared key not found                       | App Link UI | These errors can occur when our system tries to retrieve essential security credentials during **boarding** (03\_020) or both **before and after the payment** (05\_008). Restart the onboarding process. If this does not help, contact the Adyen Support team.                                   |
| 05\_003                                 | Decoding response object error                                  | App Link    | There was a problem with decoding the Base 64-encoded Terminal API response.                                                                                                                                                                                                                       |
| 05\_004                                 | Encryption error                                                | App Link    | There was a problem with the encryption of the Terminal API response. Try again. If this does not help, contact the Adyen Support team.                                                                                                                                                            |
| 05\_009                                 | Error                                                           | App Link    | This error can occur **after the payment** when our system cannot extract the transaction ID. Possibly a required parameter is missing from the Terminal API response. Try again. If this does not help, contact the Adyen Support team.                                                           |
| 05\_016 05\_017                         | Error Error                                                     | App Link    | These errors can occur **after the payment** when our system cannot retrieve the installation token to create the payment URL. Restart the payment request process. If this does not help, contact the Adyen Support team.                                                                         |

## See also

* [Maintain your Android Mobile solution](/point-of-sale/mobile-android/manage)
