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:
| Configuration | Description |
|---|---|
| NFC authentication | NFC authentication included or not |
| Required data | Which 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 type | Document side | Photo angle |
|---|---|---|
| Passport | 2 x Front | 1 x Flat 1 x Tilted |
| National ID Card | 2 x Front 2 x Back | 1 x Flat 1 x Tilted |
| Paper ID | 2 x inside right 1 x inside left 1 x Back | 1 x Flat 1 x Tilted * Only for inside right |
| Driving license | 2 x Front 2 x Back | 1 x Flat 1 x Tilted |
| Residence permit | 2 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 Front | N/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.
Updated 6 months ago