Terminal-2 icon

Error handling

Resolve errors shown on the mobile iOS device.

The Adyen payments platform performs regular checks to make sure that the mobile device on which the SDK is installed is secure. If an issue is found during the security attestation process, 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.

Error messages

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
DEBUGGER_ENABLED Transaction canceled. -x- Disconnect the debugger and try again.
INVALID_NYC1_FIRMWARE_VERSION Card reader firmware version is invalid. -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- On the device, go to Settings > General > Date & Time and turn on Set automatically.
NON_SELF_RESOLVABLE Transaction canceled. Unable to check the security requirements. -white_check_mark- Contact our Support Team to resolve the issue.
NO_TOKEN Cannot transact. -white_check_mark- Connect the device to a network so that the SDK can check the security requirements.
OFFLINE_DATA_TAMPERING An error occurred, offline data may have been lost. -white_check_mark- Connect the device to a network so that the SDK can check the security requirements.
PASSCODE_NOT_ENABLED Transaction canceled. Device passcode was removed, offline transaction data may have been lost. -white_check_mark- On the device, go to Settings > Face ID & Passcode, set a passcode for this device, and try again.
All offline "Store and Forward" transactions previously performed with a original passcode have been lost and cannot be recovered. You will not be able to continue making offline transactions until the error is resolved.
SCREEN_RECORDING Transaction canceled. -x- Stop screen recording and try again.
SCREEN_CAPTURED Transaction canceled. -x- Screen capture is not allowed. Try again.
SCREEN_TAMPERING Transaction canceled. -x- Try again. Keep the app open and in full-screen mode while the transaction is in progress.
SCREEN_OVERLAY Transaction canceled. -x- Keep the app open and in full-screen while the transaction is in progress.
SYSTEM_CHANGE Transaction canceled. Cannot transact due to system change. -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, it must go online for the SDK to check security requirements.
TOKEN_EXPIRED_S&F Offline transaction window has expired. -white_check_mark- Connect the device to a network so that the SDK can check the security requirements.

See also