iOS Trust SDK NFC Error Codes

NFC_USER_CANCELED(1001)

NFC scan was cancelled manually by the user. On iOS, this status also covers programmatic cancellation initiated by the app or SDK.

NFC_DATA_INCOMPLETE(1006)

NFC read completed with incomplete data, meaning one or more required data groups could not be read. On iOS, native interruption code 102 is also mapped to this status, so interrupted reads may surface here.

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_READER_AUTHENTICATION_ERROR(1016)

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

NFC_READER_NATIVE_TIMEOUT(1017)

The system-managed NFC session timed out before the read completed. On iOS, this describes the NFC dialog being cancelled after the system timeout expires.

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.