Biometric Authentication Integration

This page provides a step-by-step guide on how to integrate Biometric Authentication.

API-only guide

This guide provides step-by-step instructions on how to integrate Biometric Authentication via our API.

Before you begin, make sure you have completed the required setup.

Flow

Click to magnify

Biometric Authentication API flow

1. Authenticate

Create an access token to authenticate in our API:

You provide your Fourthline API credentials.
You receive an access_token.

API Reference – Create access token

Important

For security, access tokens are valid for 1 hour only.

If your token expires, create a new access token by making another Create access token request.

2. Create a case

Create a Biometric Authentication case :

You specify the case type and provide the clientId from a previous successful Identity Verification case, the client's identity data>, and your case identifier.
You receive a verificationId.

API Reference – Create Biometric Authentication

Status Status: The case status changes to new.

3. Trigger case processing

Upload the client's biometrics and location data and request Fourthline to process the case:

You provide the verificationId, selfie photo and video files, and the client's device metadata.
You receive the case status and creation timestamp.

API Reference – Process Biometric Authentication

Caution

After you start case processing, you cannot change or update any uploaded data.

Status Status: The case status changes to one of the following with the associated webhook notification:

Status	Description	Action
`pending`	We are validating the data.	Wait.
`inconsistent_data`	We found inconsistent data.	Retry.
`invalid_data`	We found invalid data.	Retry.
`completed`	We have processed the case. See the risk code: • `200`: Low risk • `500`: Unacceptable risk Webhooks: `data_corrected` or `fraud`	Download the CDD Report.

Check case status

When you receive webhook notifications, we recommend also requesting the full details:

You provide the verificationId.
You receive the case status and other relevant information.

API Reference – Get Biometric Authentication status

4. Download CDD Report

When the case status is completed, download the CDD Report:

You provide the verificationId.
A successful response is empty and the report is downloaded.

API Reference – Get CDD PDF