Document Authentication Integration

Integration guide

This page provides a step-by-step guide on how to integrate the Document Authentication solution via the API only or the App Drop-in.

Setup

Check what you need to have in place before you begin your integration:

Prerequisites

  • You need your Fourthline API key.
  • The client must have previously been onboarded by Fourthline or another licensed KYC provider.

Statuses

Set up handling for the Document Authentication statuses.

Webhook

Set up a webhook and handling for the Document Authentication notifications.

App Drop-in integration

To integrate via the App Drop-in, follow these steps:

1. Complete the configuration and setup in your selected SDK:

2. Customize the UI.

3. Capture the required data and images via the drop-in.

4. Upload the data and images to Fourthline, following the standard API flow.


Configuration

Discuss with your implementation manager the following configuration options:

ConfigurationDescription
NFC authenticationNFC authentication included or not
Required dataWhich data points in Create Document Authentication > clientData you require

Document photo requirements

The expected ID documents in differ per country.

For every required document side, you must provide a flat image and a tilted image to help us detect more security features.

For clients previously onboarded by:

  • Fourthline: These values are retrieved automatically from the client's latest successful Identity Verification case.
  • Another KYC provider: You are responsible for the quality and accuracy of the data.

See the following table for the expected number of files per document type:

Document typeDocument sidePhoto angle
Passport2 x Front1 x Flat
1 x Tilted
National ID Card2 x Front
2 x Back
1 x Flat
1 x Tilted
Paper ID2 x inside right
1 x inside left
1 x Back
1 x Flat
1 x Tilted
* Only for inside right
Driving license2 x Front
2 x Back
1 x Flat
1 x Tilted
Residence permit2 x Front
2 x Back
1 x Flat
1 x Tilted
Document video
Video length <10 seconds
Format:
• App Drop-in and API integration: mp4
• Web SDK: webm
1 x FrontN/A


Testing

Fourthline's platform is built to detect authentic ID documents with correctly matching personal data.
This means, by the nature of our business, we can't provide dummy documents, photos, files, or data for testing.

To test your Document Authentication solution:

1. Use official specimen documents, or the real ID documents and data of your colleagues, to create test cases in the sandbox environment.

2. To safeguard the privacy of your colleagues and their data, when you have finished testing, contact your implementation manager to delete all testing data from the sandbox.

More information
For more information about how Fourthline protects data, see Security & Compliance.

Top of page