Identity Verification Integration

App Drop-in guide

This guide provides step-by-step instructions on how to integrate the European Identity Verification solution with the App Drop-in.

Before you begin, make sure you have completed the following:

• App Drop-in Setup with your chosen SDK
• App UI Customization
• Identity Verification Setup

---

Flow

Click to magnify.

---

1. Authenticate

Create an access token to authenticate in our API:

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

Important

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

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

---

2. Create workflow

Create a European Identity Verification workflow:

• You specify the workflowName and provide your unique identifier for the client.
• You receive a workflowId and a Fourthline clientId.

Status: The Identity Verification case status changes to new.

- Upload identity data

If configured, upload relevant identity data:

• You provide the verificationId and relevant data points.
• A successful response is empty.

---

3. Create SDK session

Create the App Drop-in session:

• You provide the workflowId.
• You receive a validationCode to pass to the SDK in your backend.

Important

• SDK validation codes are single-use and expire after 2 hours.
• If the client stops partway through the workflow, create a new SDK session.
• When the client closes the app, the validationCode is invalidated and removed from the cache.

Status: The case status changes to one of the following and we send the relevant webhook notification:

Status: The case status then changes to one of the following and we send a webhook notification:

- Check case status

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

• You provide the verificationId (same value as the workflowId).
• You receive all the data on the case.

Important

Prevent duplicate submissions by following the recommended handling described here.

---

4. Download CDD Report

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

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