Document Authentication Integration
Integration Guides
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 credentials.
- 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 Fourthline delivery 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 identity 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 identity documents with correctly matching personal data .
This means, by the nature of our business, we cannot provide dummy documents, photos, files, or data for testing.
To test your Document Authentication solution:
1. Use official specimen documents, or the real identity 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 Fourthline delivery manager to delete all testing data from the Sandbox.
Next steps
Continue with the API-only guide to configure your integration.
More information
For more information about how Fourthline protects data, see Security & Compliance.
Updated 25 days ago