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

API-only guide

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

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

Flow

Click to magnify

1. Authenticate

Create an access token to authenticate in our API:

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

📖

Create access token

Open Recipe

API Reference – Create access token

Important

For security, access tokens are valid for 1 hour only.
If your token expires, make another Create access token request.

2. Create a case

Create a Client 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.

📖

Create Client Authentication case

Open Recipe

API Reference – Create Client Authentication

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.

📖

Process Client Authentication

Open Recipe

API Reference – Process Client Authentication

Caution

After triggering case processing, you can't change or update any uploaded data.

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.

📖

Get Client Authentication status

Open Recipe

API Reference – Get Client 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.

📖

Download CDD Report

Open Recipe

API Reference – Get CDD PDF

Success

You have integrated Client Authentication!

Top of page