Skip to main content

Get Started

This guide will help you get started with Scandit ID Validate. There are two verifiers available:

Integrating ID Validate into your app follows the same general steps as integrating ID Capture, with some minor differences based on the verifier you choose, as detailed in the following sections.

VIZ Barcode Comparison Verifier​

This verifier compares the data from the VIZ (the machine-readable zone) and the barcode on the back of the document and requires the front and back scanning mode.

Create the verifier and initialize IdCapture with the following settings:

const context = DataCaptureContext.create();

const verifier = AamvaVizBarcodeComparisonVerifier.create();

const settings = new IdCaptureSettings()
settings.supportedDocuments = [IdDocumentType.DLVIZ]
settings.supportedSides = SupportedSides.FrontAndBack

const idCapture = IdCapture.forContext(dataCaptureContext, settings)

Then proceed to capture the front and back sides of a document as usual. After you capture the back side and receive the combined result for both sides, you may run the verifier as follows:

const idCaptureListener = {
    didCaptureId: async (_, session) => {
        const capturedId = session.newlyCapturedId;
        const vizResult = capturedId.vizResult;

        if (vizResult && vizResult.capturedSides === Scandit.SupportedSides.FrontAndBack) {
            const result = await verifier.verify(session.newlyCapturedId);
            if (result.checksPassed) {
                // Nothing suspicious was detected.
            } else {
                // You may inspect the results of individual checks, if you wish:
                if (result.datesOfBirthMatch.checkResult === ComparisonCheckResult.Failed) {
                    // The holder’s date of birth from the front side does not match the one encoded in the barcode.
                }
            }
        }
    }
}

The return value allows you to query both the overall result of the verification and the results of individual checks. See AAMVAVizBarcodeComparisonResult for details.

Barcode Verifier​

This verifier analyzes the barcode on the back of the document and works with either single-sided or front and back scanning modes.

Start with creating a capture context and the verifier:

const barcodeVerifier = await AamvaBarcodeVerifier.create(dataCaptureContext)

Then initialize the desired scanning mode:

// Single-sided scanning mode
const settings = new IdCaptureSettings();
settings.supportedDocuments = [IdDocumentType.AAMVABarcode];

const idCapture = await IdCapture.forContext(context, settings);

// Front and back scanning mode
const settings = new IdCaptureSettings();
settings.supportedDocuments = [IdDocumentType.DLVIZ]
settings.supportedSides = SupportedSides.FrontAndBack;

const idCapture = await IdCapture.forContext(dataCaptureContext, settings)

Once the capture is complete, trigger the verification process. This process is asynchronous and the result will be delivered once the verification has been completed:

didCaptureId: async (idCaptureInstance, session) => {
  const capturedId = session.newlyCapturedId;

  const barcodeVerifier = await SDCId.AamvaBarcodeVerifier.create(dataCaptureContext);
  const result = await barcodeVerifier.verify(capturedId);
  if (result.error) {
    // May happen if the license key does not permit barcode verification.
  } else if (result.allChecksPassed) {
    // Nothing suspicious was detected.
  } else {
    // Document may be fraudulent or tampered with - proceed with caution.
  }
}