Users can scan their ID document and capture a selfie. Yoti accepts ID documents from over 200 countries and territories.
Yoti matches the selfie to the document and verifies authenticity. You will receive an over/under age result or date of birth. It takes just one second on average to complete this particular check and provides instant results.
Yoti will extract the information from the ID document and calculate if you meet the age requirement using the date of birth. If the image the user has provided is not clear, we will ask the user to retry in the session.
For extra security, you may also ask the user to take a selfie using the camera on their device. This is to make sure the ID document belongs to the same user, and is how we stop fraudsters from impersonating users. Multiple images will be captured, and the clearest image will be analysed using face matching technology. This will create a biometric template of the user's face, which will be compared to the photo on the ID document.
We store any data captured, such as the ID document and selfie, in our UK data centre. Once the session has been completed, we delete all personal information. If the session is left incomplete, then we will delete the data 25 hours after session expiry, whichever is sooner. We do not use the data for any other purpose.
This method is good for:
- High assurance
- Global coverage
Request body
If you wish to enable the doc scan service, please see below:
{ "type": "OVER", "doc_scan": { "allowed": true, "threshold": 18, "authenticity": "AUTO", "level": "PASSIVE", "preset_issuing_country": "GBR" }, "ttl": 900, "reference_id": "over_18_example", "callback": { "auto": true, "url": "https://www.yoti.com" }, "notification_url": "https://yourdomain.example/webhook", "cancel_url": "https://www.yoti.com", "synchronous_checks": true}| Parameter | Types | Description |
|---|---|---|
| allowed | true / false | Enable the verification method to be available for the user to use. |
| threshold | Integer e.g. 30 | Age threshold for under/over age limits. We recommend this to be the exact age of the threshold you want to cover. |
| authenticity | AUTO | Verification of the ID Document authenticity. |
| level | NONE / PASSIVE | The level of anti-spoofing for each age verification method. PASSIVE enables a passive liveness test and face match for IDV. |
| preset_issuing_country | Three letter country code e.g GBR | Determines the preset issuing country for the document selection. |
| synchronous_checks | true / false | If set to true, ensures that all methods have a result ready before the user is redirected to the callback URL. Authenticity must be set to 'AUTO'. Default is false, this primarily affects document checks and credit card checks as these are async. |
| disable_mobile_hand_off | true / false | Launching the document scan flow will encourage the user to continue on a mobile device (if browsing on desktop), this is to aid higher quality image captures. The handover is managed through a QR code. Set this flag to true to disable the QR handover. Set this flag to false to enable it. |
__
Authenticity explained
Below will allow you to configure if you want a document ID verification check on the document.
| Setting | Explained |
|---|---|
| OFF | Once the document is uploaded Yoti will attempt to extract the date of birth. |
| AUTO | Once the document is uploaded Yoti will attempt to extract the date of birth and perform automated checks on the document. To read more about the automated checks please head over here. |