AAMVA VIZ Barcode Comparison Verifier#

Defined in framework ScanditIdCapture

SDCComparisonCheckResult#

Added in version 6.11.0

The result of a comparison done by SDCAAMVAVizBarcodeComparisonVerifier of a single piece of data from an AAMVA-compliant personal identification document.

SDCComparisonCheckResultPassed#

Added in version 6.11.0

The compared data matches. In some instances the check may permit minor data divergence, to compensate, for example, for a single character misread by OCR.

SDCComparisonCheckResultFailed#

Added in version 6.11.0

Some suspicious differences detected. This doesn’t automatically mean that the document is fraudulent, but such document should be inspected more carefully.

SDCComparisonCheckResultSkipped#

Added in version 6.11.0

The data necessary to perform the check is missing and thus it is skipped.

SDCComparisonCheck#
@protocol SDCComparisonCheck <NSObject>

Added in version 6.11.0

A comparison done by SDCAAMVAVizBarcodeComparisonVerifier of a single piece of data from an AAMVA-compliant personal identification document.

checkResult#
@property (nonatomic, readonly) SDCComparisonCheckResult checkResult

Added in version 6.11.0

Whether any suspicious divergence in data is detected.

resultDescription#
@property (nonatomic, nonnull, readonly) NSString *resultDescription

Added in version 6.11.0

The human-readable result of the comparison.

SDCStringComparisonCheck#
@interface SDCStringComparisonCheck : NSObject <SDCComparisonCheck>

Added in version 6.11.0

The result of the comparison of a string field performed by SDCAAMVAVizBarcodeComparisonVerifier. Check SDCComparisonCheck for more informations.

aamvaBarcodeValue#
@property (nonatomic, nullable, readonly) NSString *aamvaBarcodeValue

Added in version 6.11.0

The string field extracted from a barcode present at the back side of an AAMVA-compliant personal identification document.

vizValue#
@property (nonatomic, nullable, readonly) NSString *vizValue

Added in version 6.11.0

The string field extracted from a human-readable front side of an AAMVA-compliant personal identification document.

SDCDateComparisonCheck#
@interface SDCDateComparisonCheck : NSObject <SDCComparisonCheck>

Added in version 6.11.0

The result of the comparison of a SDCDateResult field performed by SDCAAMVAVizBarcodeComparisonVerifier. Check SDCComparisonCheck for more informations.

aamvaBarcodeValue#
@property (nonatomic, nullable, readonly) SDCDateResult *aamvaBarcodeValue

Added in version 6.11.0

The SDCDateResult field extracted from a barcode present at the back side of an AAMVA-compliant personal identification document.

vizValue#
@property (nonatomic, nullable, readonly) SDCDateResult *vizValue

Added in version 6.11.0

The SDCDateResult field extracted from a human-readable front side of an AAMVA-compliant personal identification document.

SDCAAMVAVizBarcodeComparisonResult#
@interface SDCAAMVAVizBarcodeComparisonResult : NSObject

Added in version 6.11.0

The result of an AAMVA-compliant personal identification document verification conducted by SDCAAMVAVizBarcodeComparisonVerifier.

checksPassed#
@property (nonatomic, readonly) BOOL checksPassed

Added in version 6.11.0

Whether all the checks conducted by the verifier passed. Only the check that were run count, so YES is returned even if some of the checks were skipped.

issuingCountryISOMatch#
@property (nonatomic, readonly) SDCStringComparisonCheck *issuingCountryISOMatch

Added in version 6.11.0

Whether the issuing countries extracted from both sources of the data are the same.

issuingJurisdictionISOMatch#
@property (nonatomic, readonly) SDCStringComparisonCheck *issuingJurisdictionISOMatch

Added in version 6.11.0

Whether the issuing jurisdictions (for example: an issuing state, territory or federal district for USA, or an issuing province or territory for Canada) extracted from both sources of the data are the same.

documentNumbersMatch#
@property (nonatomic, readonly) SDCStringComparisonCheck *documentNumbersMatch

Added in version 6.11.0

Whether the document numbers extracted from both sources of the data match. This check may permit minor data divergence, to compensate, for example, for a single character misread by OCR.

fullNamesMatch#
@property (nonatomic, readonly) SDCStringComparisonCheck *fullNamesMatch

Added in version 6.11.0

Whether the holder’s full names extracted from both sources of the data match. This check may permit minor data divergence, to compensate, for example, for a single character misread by OCR.

datesOfBirthMatch#
@property (nonatomic, readonly) SDCDateComparisonCheck *datesOfBirthMatch

Added in version 6.11.0

Whether the holder’s dates of birth extracted from both sources of the data are the same.

datesOfExpirationMatch#
@property (nonatomic, readonly) SDCDateComparisonCheck *datesOfExpirationMatch

Added in version 6.11.0

Whether the document’s dates of expiry extracted from both sources of the data are the same.

datesOfIssueMatch#
@property (nonatomic, readonly) SDCDateComparisonCheck *datesOfIssueMatch

Added in version 6.11.0

Whether the document’s dates of issue extracted from both sources of the data are the same.

resultDescription#
@property (nonatomic, nonnull, readonly) NSString *resultDescription

Added in version 6.11.0

The human-readable result of the verification.

JSONString#
@property (nonatomic, readonly) NSString *JSONString

Added in version 6.12.0

Returns the JSON representation of the Aamva Viz Barcode Comparison result.

SDCAAMVAVizBarcodeComparisonVerifier#
@interface SDCAAMVAVizBarcodeComparisonVerifier : NSObject

Added in version 6.11.0

Verifies an AAMVA-compliant personal identification document by comparing the human-readable data from its front side with the data encoded in the barcode, and signals any suspicious differences.

The verifier may permit minor data divergence, to compensate, for example, for a single character misread by OCR. Thus, while it automatically detects many fraudulent documents, a failed check does not necessary mean that the document is invalid. It is up to the user to subject such documents to additional scrutiny.

The verification may be conducted for AAMVA-compliant personal identification documents in the front & back scanning mode. Initialize SDCIdCapture with the following settings:

let settings = IdCaptureSettings()
settings.supportedDocuments = [.dlVIZ]
settings.supportedSides = .frontAndBack

Then proceed to capture the front side & the back side 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:

func idCapture(_ idCapture: IdCapture, didCaptureIn session: IdCaptureSession, frameData: FrameData) {
    guard let capturedId = session.newlyCapturedId,
    let vizResult = capturedId.vizResult,
    vizResult.capturedSides == .frontAndBack else { return }

    let verifier  = AAMVAVizBarcodeComparisonVerifier()
    let result  = verifier.verify(capturedId)

    // Process the result
}

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

+ verifier#
+ (nonnull instancetype)verifier

Added in version 6.11.0

Creates a new instance of this verifier.

- verify:#
- (nonnull SDCAAMVAVizBarcodeComparisonResult *)verify:(SDCCapturedId *)capturedId

Added in version 6.11.0

Compares the human-readable data from the front side of the document with the data encoded in the barcode, and signals any suspicious differences.