Biometrics Reverification

The Biometrics Reverification module verifies the authenticity and liveness of a person’s image. It then matches that image against a trusted source image. The module combines three checks into a single overall result:

IAD (injection attack detection) capture liveness
Face liveness
Face match

Use this module for reverification scenarios. It confirms that the person presenting themselves is the same individual verified during an earlier onboarding or identity check. The module requires a new encrypted selfie and a previously captured anchor image to compare against. Required inputs include encrypted selfie and anchor image.

Capabilities

The module returns four capabilities: an overall result and the individual result of each underlying check.

Overall result

This capability returns the combined outcome of all reverification checks.

Code	Label	Description
`Passed`	Passed	All reverification checks passed. The selfie is live, not injected, and matches the anchor image.
`Failed`	Failed	One or more reverification checks failed.
`Error`	Error	The overall result could not be determined due to a system-level issue. This is the default value.

IAD: Capture liveness

This capability indicates whether the captured image passes injection attack detection. It confirms the selfie was taken live rather than injected from a pre-recorded or synthetic source.

Code	Label	Description
`Live`	Live	The selfie was captured live through a legitimate device camera.
`Not Live`	Not Live	An injection attack was detected. The selfie appears to have been injected from a pre-recorded or synthetic source rather than captured live.
`Error`	Error	The injection attack detection check could not be completed due to a technical issue. This is the default value.

Face liveness

This capability indicates whether the face in the selfie is a live person rather than a photo, mask, or deepfake.

Code	Label	Description
`Live`	Live	The face is live. A real, physically present person was in front of the camera when the selfie was captured.
`Not Live`	Not Live	The face is not live. The selfie may be a printed photograph, screen replay, video recording, 3D mask, or deepfake.
`Error`	Error	The face liveness check could not be completed due to a technical issue. This is the default value.

Face match

This capability indicates whether the face in the selfie matches the anchor image.

Code	Label	Description
`Match`	Match	The face in the selfie matches the anchor image.
`No Match`	No Match	The face in the selfie does not match the anchor image.
`Error`	Error	The face match check could not be completed due to a technical issue. This is the default value.

Default outcomes

The outcome logic uses only the overall result. The individual check capabilities are available for custom evaluation rules but are not used in the default outcomes.

Outcome	Condition	Description
`Success`	Overall result is `Passed`	All reverification checks passed. The selfie is live, not injected, and matches the anchor image.
`Failed`	Overall result is `Failed`	One or more reverification checks failed.
`ERROR`	Default (no conditions matched)	An unexpected error occurred during processing.

Input payload

The module requires an EncryptedSelfie input with selfieImageEncryption set to true, along with an AnchorImage input to compare against. The anchor image must be prefilled at journey start. The following is a sample payload used to submit an encrypted selfie and anchor image to the Biometrics Reverification module for processing.

JSON

{
  "resourceId": "<resourceId>",
  "context": {
    "config": {
      "delivery": "api"
    },
    "subject": {
      "biometrics": [
        {
          "selfieImageEncryption": true,
          "selfieImage": "<base64-encoded string>",
          "anchorImage": "<base64-encoded string>"
        }
      ]
    }
  }
}

Field	Required	Description
`selfieImageEncryption`	Yes	Must be set to `true` to indicate the selfie image has been encrypted for injection attack detection.
`selfieImage`	Yes	Base64-encoded encrypted selfie image captured from the end user.
`anchorImage`	Yes	Base64-encoded reference image used for comparison. This is the previously captured image from the subject’s earlier onboarding or identity check, and must be prefilled at journey start.

Sample response

The following is a sample response from the Biometrics Reverification module. In this example the selfie is live and not injected, but does not match the anchor image, so the overall result is Failed.

JSON

{
  "response": {
    "advice": {
      "contains": {
        "iadCaptureLiveness": "Live",
        "faceLiveness": "Live",
        "faceMatch": "No Match",
        "overallResult": "Failed"
      }
    },
    "outcome": "Failed"
  }
}

Capabilities

Face match

Face match result.

Value	Description
`Match`	Face matched
`No Match`	Face did not match
`Error`	Face match error

Face liveness

Face liveness result.

Value	Description
`Live`	Face is live
`Not Live`	Face is not live
`Error`	Face liveness error

IAD: capture liveness

IAD capture liveness result.

Value	Description
`Live`	Capture is live
`Not Live`	Capture is not live
`Error`	Liveness check error

Overall result

Final outcome of the reverification process.

Value	Description
`Passed`	Reverification passed
`Failed`	Reverification failed
`Error`	Reverification error

Biometrics Onboarding

Capabilities

Face match

Face match result.

Value	Description
`Match`	Face matched
`No Match`	Face did not match
`Error`	Face match error

Face liveness

Face liveness result.

Value	Description
`Live`	Face is live
`Not Live`	Face is not live
`Error`	Face liveness error

IAD: capture liveness

IAD capture liveness result.

Value	Description
`Live`	Capture is live
`Not Live`	Capture is not live
`Error`	Liveness check error

Overall result

Final outcome of the onboarding process.

Value	Description
`Passed`	Onboarding passed
`Failed`	Onboarding failed
`Error`	Onboarding error

Get Started

Platform

API-first integration

Hosted journey

Digital IDs

Resources

Biometrics Reverification

Capabilities

Overall result

IAD: Capture liveness

Face liveness

Face match

Default outcomes

Input payload

Sample response