Guides
System status

Identity Verification Integration

Integration Guides

Setup

Mobile SDK

API Guide

Web SDK guide

This guide provides step-by-step instructions on how to integrate the European Identity Verification solution with the Web SDK.

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

Flow

Click to magnify.

European solution Web SDK flow

1. Authenticate

Create an access token to authenticate in our API:

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

Tutorial: Create 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 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.
📖

Tutorial: Create workflow

API Reference: Create workflow

Status 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.
📖

Tutorial: Upload identity data

API Reference: Upload identity data

3. Create SDK session

Create the Web SDK session:

  • You provide the workflowId.
  • You receive an 8-digit, alphanumerical validationCode to pass to the SDK in your backend.

If the client starts on your website in their:

  • Desktop browser: Initialize the Web SDK, display the redirect options, and redirect the client to the workflow in their mobile browser.
  • Mobile browser: Display the redirect options and then redirect them to the workflow on your subdomain.
📖

Tutorial: Create Web SDK session

API Reference: Create SDK session

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 browser, the validationCode is invalidated and removed from the cache.

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

StatusDescriptionAction
pendingThe data is valid.Wait for the next status.
invalid_dataInvalid or missing data.Create a new workflow.

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

StatusDescriptionAction
inconsistent_dataWe found inconsistent data.Create a new workflow.
completedWe have processed the case.
For our recommendation to accept or reject the client, see the risk code.		Download the CDD Report.

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.
📖

Tutorial: Get case status

API Reference: Get case status

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.
📖

API Reference: Get CDD zipfile

Updated 3 months ago

Related pages