Getting started with liveness

What is liveness?

Liveness verification is a feature that helps to make sure your user is a real, live person when they take a live picture to submit their selfie. Liveness verification helps to prevent fraudulent activity and bad actors from being verified.

When Liveness mode is enabled, the user will be asked to perform an action (ex. turn their head left) before they're allowed to move to the next step. 

Liveness modes

The following liveness modes are available to use. Each verification job can only use one liveness mode at a time:

• Straight: The user looks straight at the camera. Vouched detects minor facial movements.
• Orientation: The user is asked to turn their face left, then right.
• Mouth: The user is asked to open and close their mouth.
• Distance: The user is asked to move closer to and further from the camera.

How do I enable liveness?

If you're using the JS Plugin:

Add the liveness parameter to your JS Plugin code, and set the value based on which liveness mode you want to use. Only use one of the liveness parameters below:

liveness: 'straight', // straight mode
liveness: 'orientation', // orientation mode
liveness: 'mouth', // mouth mode
liveness: 'distance', // distance mode

If you're using the Mobile SDKs:

Take a look at our SDK documentation for iOS, Android, and React Native. 

If you're using the Invite API or Vouched Now:

Reach out to our support team for assistance.

If you're using the REST API:

Liveness is not supported with the REST API integration. 

Which liveness mode should I use?

Deciding on the liveness mode to use depends on your conversion and security goals. 

Straight liveness is the easiest for the user and is best suited towards organizations who are optimizing for high conversion and are comfortable with a solid level of security.

Orientation, Mouth, or Distance mode is recommended for organizations who need higher security and are comfortable with asking the user to perform an additional check during the verification process.