Rejection Reason

Defined in package com.scandit.datacapture.id.data

RejectionReason

Added in version 6.24.0

Possible reasons why a document can be rejected.

When multiple rejection conditions apply, only the highest-priority reason is reported. The evaluation order, from highest to lowest priority, is:

  1. NOT_ACCEPTED_DOCUMENT_TYPE — document is in the rejected list

  2. NOT_ACCEPTED_DOCUMENT_TYPE — document is not in the accepted list

  3. FORGED_AAMVA_BARCODE

  4. NOT_REAL_ID_COMPLIANT

  5. INCONSISTENT_DATA

  6. HOLDER_UNDERAGE

  7. DOCUMENT_EXPIRED

  8. DOCUMENT_EXPIRES_SOON

  9. TIMEOUT

  10. DOCUMENT_VOIDED, INVALID_FORMAT, and others

Although INVALID_FORMAT has the lowest priority in the evaluation order, it arises when a document cannot be parsed at all. In that case, document type and authenticity cannot be determined, so higher-priority reasons are not applicable in practice.

For two-sided documents, INCONSISTENT_DATA is only evaluated after both sides have been captured. If the front side triggers a rejection — such as HOLDER_UNDERAGE, DOCUMENT_EXPIRED, or DOCUMENT_EXPIRES_SOON — the back side is not scanned and INCONSISTENT_DATA is never evaluated, even though it ranks higher in the precedence order.

NOT_ACCEPTED_DOCUMENT_TYPE

Added in version 6.24.0

The type of the presented document is not enabled in the settings.

INVALID_FORMAT

Added in version 6.24.0

The document format is incorrect.

DOCUMENT_VOIDED

Added in version 6.24.0

The document is voided.

TIMEOUT

Added in version 7.0.0

The capture process resulted in a timeout.

SINGLE_IMAGE_NOT_RECOGNIZED

Added in version 7.0.0

The capture process resulted in no result. This reason is only used in conjunction with a single image frame source. ID Capture is automatically :meth:id.IdCapture.Reset when this rejection happens. Currently only used by the Web platform

DOCUMENT_EXPIRED

Added in version 7.1.0

The document is expired.

DOCUMENT_EXPIRES_SOON

Added in version 7.1.0

The document will expire soon.

NOT_REAL_ID_COMPLIANT

Added in version 7.1.0

The document is not REAL ID compliant.

HOLDER_UNDERAGE

Added in version 7.1.0

The document’s holder is underage.

FORGED_AAMVA_BARCODE

Added in version 7.1.0

The document has a forged AAMVA barcode.

INCONSISTENT_DATA

Added in version 7.1.0

The document has inconsistent data.

BLUETOOTH_COMMUNICATION_ERROR

Added in version 7.5.0

An error occurred while retrieving the document data via Bluetooth.

BLUETOOTH_UNAVAILABLE

Added in version 7.5.0

Bluetooth is not supported, disabled, or missing required permissions on your device.