Get Started

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

• AAMVAVizBarcodeComparisonVerifier: Validates the authenticity of the document by comparing the data from the VIZ and from the barcode on the back.
• AAMVABarcodeVerifier: Validates the authenticity of the document by analyzing the barcode on the back.

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:

DataCaptureContext dataCaptureContext = DataCaptureContext.forLicenseKey('-- ENTER YOUR SCANDIT LICENSE KEY HERE --');

AamvaVizBarcodeComparisonVerifier verifier = AamvaVizBarcodeComparisonVerifier.create()

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

IdCapture 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:

@override
void didCaptureId(IdCapture idCapture, IdCaptureSession session) {
    if (session.newlyCapturedId == null) {
      return;
    }
    idCapture.isEnabled = false;

    CapturedId capturedId = session.newlyCapturedId!;
    var vizResult = capturedId.viz;

    if (vizResult != null && vizResult.capturedSides == SupportedSides.frontAndBack) {
      AamvaVizBarcodeComparisonVerifier verifier = AamvaVizBarcodeComparisonVerifier.create();
      verifier.verify(capturedId).then((result) => {
            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:

var dataCaptureContext = DataCaptureContext.forLicenseKey("-- ENTER YOUR SCANDIT LICENSE KEY HERE --");
var barcodeVerifier = await AamvaBarcodeVerifier.create(dataCaptureContext);

Then initialize the desired scanning mode:

// Single-sided scanning mode
var settings = IdCaptureSettings();
settings.supportedDocuments.add(IdDocumentType.aamvaBarcode);

var idCapture = IdCapture.forContext(dataCaptureContext, settings);

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

// Front and back scanning mode
var settings = IdCaptureSettings();
settings.supportedDocuments.add(IdDocumentType.dlViz);
settings.supportedSides = SupportedSides.frontAndBack;

var idCapture = 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:

@override
void didCaptureId(IdCapture idCapture, IdCaptureSession session) async {
  if (session.newlyCapturedId == null) {
    return;
  }
  CapturedId capturedId = session.newlyCapturedId!;
  var barcode = capturedId.aamvaBarcode;
  if (barcode != null) {
    barcodeVerifier.verify(capturedId).then((result) {
      if (result.allChecksPassed) {
        // Nothing suspicious was detected.
      } else {
        // Document may be fraudulent or tampered with - proceed with caution.
      }
    }, onError: (error) {
        // Error occurred during verification
    });
  }
}