Skip to main content
The Data and Biometrics Verification module performs identity checks that combine document data with biometric verification. It verifies a subject’s identity by comparing the information and facial image captured from their identity document against the original government record held by the document’s issuing authority. This page contains documentation for the Data and Biometrics Verification module, including its variants, capabilities, and the specific result codes it returns. The module has two variants using Australia’s national Face Verification Service (FVS). Both variants perform the same type of check but against different document types.
VariantDocument typeIssuing authority
Australia: FVS Driver LicenceDriver’s licenceState or territory road authority
Australia: FVS PassportPassportAustralian Passport Office

​
Australia: FVS Driver Licence

This variant performs a Facial Verification Service (FVS) check for Australian driver’s licences. It submits the subject’s facial image and driver’s licence details to Australia’s national Face Verification Service, which compares the submitted information against the original licence record held by the relevant state or territory road authority. The check requires the subject’s express consent before their identity can be verified. The FVS returns a simple match or mismatch result. It doesn’t share the original photograph or any personal information from the government record.

​
Capabilities

The module returns a single capability: the FVS result, which indicates whether the submitted facial image and document details matched the original government record.

​
FVS result

This capability returns the outcome of the facial verification check against the government record. The result indicates whether the submitted photograph and biographic data match the issuing authority’s original record for the specified driver’s licence.
LabelDescription
Identity MatchThe submitted facial image and document details matched the original government record. The person on the document is confirmed to be the person on file with the issuing authority. This is a positive verification result.
Identity MismatchThe submitted facial image or document details didn’t match the original government record. The person on the document couldn’t be confirmed as the person on file. This may indicate that the document belongs to a different person, the facial image is of insufficient quality for comparison, or the biographic details don’t match the issuing authority’s records.
AlertThe document is flagged as invalid or wasn’t electronically captured. This result indicates a problem with the document itself rather than a facial mismatch. Possible causes include: the driver’s licence number doesn’t exist in the issuing authority’s records, or the licence has been cancelled or revoked.
ErrorA system-level error prevented the check from completing. This may occur due to a service outage, a connectivity issue with the FVS gateway, or a problem with the request format. The check should be retried or the journey should route to a fallback verification method.

​
Default outcomes

The module is pre-configured with the following default outcomes, which can be configured and used in evaluation and routing logic within the Journey builder.
OutcomeConditionDescription
Identity MatchFVS result is YThe subject’s identity was successfully verified against the government record. The journey can proceed with confidence.
Identity MismatchFVS result is NThe subject’s identity could not be verified. The facial image or document details did not match the government record. Depending on your policy, this may route to manual review, a request to recapture the facial image, or rejection.
AlertFVS result is DThe document itself could not be validated against the government system. This is different from a facial mismatch. The issue is with the document’s status or availability in the national system, not with the biometric comparison. The journey may route to manual review or prompt the user to submit an alternative document.
ErrorDefault (no conditions matched)A system error prevented the verification from completing. This fallback outcome typically indicates a connectivity or service issue rather than a problem with the subject’s identity or document.

​
Input payload

The following is a sample payload used to submit driver’s licence details and a selfie image to the Australia: FVS Driver Licence variant for processing.
JSON
{
  "resourceId": "<resourceId>",
  "context": {
    "subject": {
      "identity": {
        "firstName": "<string>",
        "middleNames": ["<string>"],
        "lastNames": ["<string>"],
        "dateOfBirth": "<YYYY-MM-DD>"
      },
      "documents": [
        {
          "number": "<string>",
          "cardNumber": "<string>",
          "state": "<string>"
        }
      ],
      "biometrics": [
        {
          "selfieImage": "<base64-encoded string>"
        }
      ]
    }
  }
}
FieldRequiredDescription
identity.firstNameYesFirst name of the subject.
identity.middleNamesNoArray containing middle name(s) of the subject.
identity.lastNamesYesArray containing the last name(s) of the subject.
identity.dateOfBirthYesDate of birth in YYYY-MM-DD format.
documents[].numberYesDriver licence number.
documents[].cardNumberYesCard number printed on the driver licence.
documents[].stateYesAustralian state that issued the licence (for example, "nsw").
biometrics[].selfieImageYesBase64-encoded selfie image of the subject.

​
Australia: FVS Passport

This variant performs a Facial Verification Service (FVS) check for Australian passports. The FVS returns a match or mismatch result without sharing the original passport photograph or any additional personal information from the government record.

​
Capabilities

The module returns a single capability: the FVS result, which indicates whether the submitted facial image and passport details matched the original government record.

​
FVS result

This capability returns the outcome of the facial verification check against the government passport record. The result indicates whether the submitted photograph and biographic data match the Australian Passport Office’s original record for the specified passport.
LabelDescription
Identity MatchThe submitted facial image and passport details matched the original government record. The person presenting the passport is confirmed to be the person on file with the Australian Passport Office.
Identity MismatchThe submitted facial image or passport details didn’t match the original government record. The person couldn’t be confirmed as the passport holder on file. This may indicate the passport belongs to a different person, the facial image quality is insufficient for comparison, or the biographic details, such as name, date of birth, or passport number don’t match the issuing authority’s records.
AlertThe passport is flagged as invalid or was not electronically captured. Possible causes include: the passport number does not exist in the Australian Passport Office’s records, the passport has been cancelled or reported lost or stolen, the passport has expired and is no longer held in the active verification system, or the document is not an Australian passport.
ErrorA system-level error prevented the check from completing. This may occur due to a service outage, a connectivity issue with the FVS gateway, or a problem with the request format.

​
Default outcomes

The default outcomes for the passport variant are identical to the driver’s licence variant.
OutcomeConditionDescription
Identity MatchFVS result is YThe subject’s identity was successfully verified against the government passport record.
Identity MismatchFVS result is NThe subject’s identity could not be verified. The facial image or passport details did not match the government record.
AlertFVS result is DThe passport could not be validated against the government system. The issue is with the document’s status or availability, not the biometric comparison.
ErrorDefault (no conditions matched)A system error prevented the verification from completing.

​
Input payload

The following is a sample payload used to submit passport details and a selfie image to the Australia: FVS Passport variant for processing.
JSON
{
  "resourceId": "<resourceId>",
  "context": {
    "subject": {
      "identity": {
        "firstName": "<string>",
        "middleNames": ["<string>"],
        "lastNames": ["<string>"],
        "dateOfBirth": "<YYYY-MM-DD>",
        "gender": "<string>"
      },
      "documents": [
        {
          "number": "<string>"
        }
      ],
      "biometrics": [
        {
          "selfieImage": "<base64-encoded string>"
        }
      ]
    }
  }
}
FieldRequiredDescription
identity.firstNameYesFirst name of the subject.
identity.middleNamesNoArray containing middle name(s) of the subject.
identity.lastNamesYesArray containing the last name(s) of the subject.
identity.dateOfBirthYesDate of birth in YYYY-MM-DD format.
identity.genderYesGender of the subject. Accepted values: "M", "F". Required for this variant.
documents[].numberYesPassport number.
biometrics[].selfieImageYesBase64-encoded selfie image of the subject.