{"title":"Error handling","category":"default","creationDate":1776961627,"content":"

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. <\/p>\n

Error messages<\/h2>\n

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<\/strong> to learn if your integration needs internet connectivity to resolve the error.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Error code<\/th>\nDescription<\/th>\nInternet needed to resolve<\/th>\nRequired action<\/th>\n<\/tr>\n<\/thead>\n
DEBUGGER_ENABLED<\/td>\nTransaction canceled.<\/td>\n\"-x-\"<\/td>\nDisconnect the debugger and try again.<\/td>\n<\/tr>\n
INVALID_NYC1_FIRMWARE_VERSION<\/td>\nCard reader firmware version is invalid.<\/td>\n\"-white_check_mark-\"<\/td>\nUpdate the card reader to the latest software version and try again.<\/td>\n<\/tr>\n
LOCAL_TIME_TAMPERING<\/td>\nTransaction canceled. Unable to check the security requirements.<\/td>\n\"-white_check_mark-\"<\/td>\nOn the device, go to Settings<\/strong> > General<\/strong> > Date & Time<\/strong> and turn on Set automatically<\/strong>.<\/td>\n<\/tr>\n
NON_SELF_RESOLVABLE<\/td>\nTransaction canceled. Unable to check the security requirements.<\/td>\n\"-white_check_mark-\"<\/td>\nContact our Support Team<\/a> to resolve the issue.<\/td>\n<\/tr>\n
NO_TOKEN<\/td>\nCannot transact.<\/td>\n\"-white_check_mark-\"<\/td>\nConnect the device to a network so that the SDK can check the security requirements.<\/td>\n<\/tr>\n
OFFLINE_DATA_TAMPERING<\/td>\nAn error occurred, offline data may have been lost.<\/td>\n\"-white_check_mark-\"<\/td>\nConnect the device to a network so that the SDK can check the security requirements.<\/td>\n<\/tr>\n
PASSCODE_NOT_ENABLED<\/td>\nTransaction canceled. Device passcode was removed, offline transaction data may have been lost.<\/td>\n\"-white_check_mark-\"<\/td>\nOn the device, go to Settings<\/strong> > Face ID & Passcode<\/strong>, set a passcode for this device, and try again.
All offline \"Store and Forward\" transactions previously performed with the original passcode have been lost and cannot be recovered. You will not be able to continue making offline transactions until the error is resolved. <\/div><\/div><\/td>\n<\/tr>\n
SCREEN_RECORDING<\/td>\nTransaction canceled.<\/td>\n\"-x-\"<\/td>\nStop screen recording and try again.<\/td>\n<\/tr>\n
SCREEN_CAPTURED<\/td>\nTransaction canceled.<\/td>\n\"-x-\"<\/td>\nScreen capture is not allowed. Try again.<\/td>\n<\/tr>\n
SCREEN_TAMPERING<\/td>\nTransaction canceled.<\/td>\n\"-x-\"<\/td>\nTry again. Keep the app open and in full-screen mode while the transaction is in progress.<\/td>\n<\/tr>\n
SCREEN_OVERLAY<\/td>\nTransaction canceled.<\/td>\n\"-x-\"<\/td>\nKeep the app open and in full-screen while the transaction is in progress.<\/td>\n<\/tr>\n
SYSTEM_CHANGE<\/td>\nTransaction canceled. Cannot transact due to system change.<\/td>\n\"-x-\"<\/td>\nConnect 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. <\/div><\/div><\/td>\n<\/tr>\n
TOKEN_EXPIRED_S&F<\/td>\nOffline transaction window has expired.<\/td>\n\"-white_check_mark-\"<\/td>\nConnect the device to a network so that the SDK can check the security requirements.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

See also<\/h2>\n