Android Trust SDK NFC Error Codes

NFC_USER_CANCELED(1001)

NFC scan was cancelled manually by the user.

NFC_INPUT_PARSING_ERROR(1003)

NFC input data parsing failed. This typically means supplied chip-read input such as BAC or MRZ data could not be parsed correctly before or during the NFC operation.

NFC_DIALOG_RENDERING_FAILED(1004)

NFC dialog rendering failed because the Android NFC dialog fragment transaction could not be completed successfully.

NFC_BACKGROUND_READING_FAILED(1005)

App went to the background during NFC reading, causing the scan to be interrupted or cancelled before completion.

NFC_DATA_INCOMPLETE(1006)

NFC read completed with incomplete data, meaning one or more required data groups could not be read.

NFC_READER_NO_DATA_ERROR(1007)

NFC scanning process found no data available from the tag. In Android native SDK terms, this aligns with ERROR_NO_DATA, indicating no tag reader data was made available.

NFC_READER_INTERRUPT_ERROR(1008)

NFC reader failed unexpectedly during processing. In the Android native SDK mapping, this corresponds to ERROR_UNEXPECTED, a catch-all for unexpected reader failures.

NFC_READER_TAG_NOT_SUPPORTED_ERROR(1009)

NFC tag or document is not supported. On Android, this maps to ERROR_TAG_NOT_SUPPORTED, which can occur when the NFC intent contains a null or unsupported tag, including transient bad reads or brief tag misalignment.

NFC_READER_NOT_IMPLEMENTED_ERROR(1010)

NFC scan failed because the required reader implementation is unavailable or not implemented. In practice, this can indicate the document or tag does not support the expected reader path.

NFC_READER_LICENSE_ERROR(1011)

NFC scanning failed because the NFC SDK license is invalid. A retry will not usually succeed unless the license or application configuration changes.

NFC_READER_UNKNOWN_ERROR(1012)

NFC scanning failed due to an unknown native NFC error without a more specific TrustX mapping. This is the generic fallback for native NFC failures.

NFC_DISPATCHER_ENABLE_ERROR(1013)

NFC foreground dispatcher could not be enabled, preventing Android from correctly routing NFC events to the active scan flow.

NFC_INTENT_ERROR(1014)

Received Android intent is not compatible with NFC processing, so the scan cannot proceed.

NFC_READER_AUTHENTICATION_ERROR(1016)

NFC chip authentication failed. This can occur during chip access or MRZ/BAC/PACE-related authentication with the document chip.

OPERATION_INPUT_PARSING_ERROR(2002)

Input payload passed into the NFC operation is invalid or could not be parsed correctly. This is broader than chip-reader parsing and refers to invalid operation-call input.

APP_PROCESS_BACKGROUNDED(2003)

Application moved to the background or entered a stopped lifecycle state while the NFC operation was active, causing the operation to fail.