API-only guide

This guide provides step-by-step instructions on how to integrate the Italian Identity Verification solution via our API.

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

Italian solution setup
Let your Fourthline delivery manager know if you want the following parameters in the Upload identity data request to be required or optional:
- person.name
- person.placeOfBirth

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.

Recipe: Create access token

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 workflow

Create an Italian workflow, providing your unique identifier for the client:

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

Recipe: Create Italian workflow

API Reference: Create workflow

Status Status: The Identity Verification case status changes to new.

3. Upload identity data

Upload the client's identity data>:

You provide the verificationId (same value as the workflowId) and always the person, address, emailAndPhone, and riskRequirements objects.
A successful response is empty.

Recipe: Upload Italian identity data

:API Reference: Upload identity data

Status Status: The case status remains new.

4. Upload identity files

Upload the client's identity document and supporting identity files:

You provide the verificationId (same value as the workflowId).
A successful response is empty.

Important

For detailed instructions on how to use this request, see the
user guide.

Recipe: Upload identity files

API Reference: Upload identity files

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

Status	Description	Action
`pending`	The data is valid.	Wait for the next status.
`invalid_data`	We found invalid or missing data.	Create a new workflow.

5. Start case processing

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

Status	Description	Action
`inconsistent_data`	We found inconsistent data.	Create a new workflow.
`completed`	We have processed the case. For our recommendation to accept or reject the client, see the risk code.	Download the CDD Report.

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.

Recipe: Get case status

API Reference: Get case status

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

Recipe: Get CDD zipfile
API Reference: Get CDD zipfile

Success

You have successfully integrated the Italian solution.

Italian Solution Integration