> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-en/products/editor-1/facephi-onboarding/mobile/android/demo.md).
# Demo
**What's New Onboarding v.7.0.0**
New version 7.0.0. Interface update.
### **Introduction**[](#introducción)
Facephi Onboarding is an application that allows you to perform an online onboarding easily, in 2 to 5 steps. It starts with a configurable flow where the user will have to capture their document and take a photo. At the end, a results screen appears where you can check the information extracted from both the biometrics and the personal data and security validations. This data can be consulted from Facephi Platform.
### **Requirements and installation**[](#requisitos-e-instalación)
Facephi Onboarding is compatible with Android 8 - Oreo devices or later.
The application can be downloaded from [this link](https://play.google.com/store/apps/details?id=com.facephi.demo.wizard). It is recommended to keep it up to date.
This manual will show Facephi Onboarding with all its features enabled. If you do not have any of these features in your demo, check the enabled services with your representative.
### **Log in**[](#iniciar-sesión)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Enter the email (1) and password (2) to log in. By tapping the icon (3) you can see the password you entered. Once entered, press the button (4) to proceed to the next screen.
You can also tap the hyperlinks to create an account (5) and view the legal texts (6).
1. Username text input
2. Password text input
3. Show password button
4. Log in button
5. Link to create an account
6. Link to view the legal texts
{% endcolumn %}
{% endcolumns %}
***
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If the entered user and/or password are incorrect, a message appears informing you and allowing you to try again (1).
1. Retake button
{% endcolumn %}
{% endcolumns %}
***
### **General Data Protection Regulation**[](#reglamento-general-de-protección-de-datos)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Through the “Privacy Policy - Terms” link, the General Data Protection Regulation is displayed. To close this message, press the button (1).
1. Close button
{% endcolumn %}
{% endcolumns %}
***
### **Create account**[](#crear-cuenta)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
To create an account, you must complete the required fields (1)(2)(3). You must check the box to give consent regarding personal data (4). Optionally, you can also view the privacy policy by tapping the hyperlink (5).
Finally, complete the CAPTCHA (6) and press the button (7) to create your account.
1. Name text field
2. Surname text field
3. Email text field
4. Consent checkbox
5. Privacy Policy hyperlink
6. CAPTCHA checkbox
7. Create account button
{% endcolumn %}
{% endcolumns %}
***
### **App permissions**[](#permisos-de-la-app)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Facephi Onboarding needs you to allow camera access to make the document and face captures, among other things.
If you do not want to grant these permissions, press the button (1). If you allow camera access, press the button (2).
1. Deny button
2. Allow access button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
One of the required app permissions is location. It is used to collect geolocation data and select the corresponding data for the document in your country. If you reject these permissions, the application will use your device's country as a reference to select the type of document.
If you do not want to grant these permissions, press the button (1). If you want to allow location access, press the button (2).
1. Deny button
2. Allow button
{% endcolumn %}
{% endcolumns %}
***
### **Choose document and country**[](#elegir-documento-y-país)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
This is where the onboarding begins. You can configure it by tapping the Settings icon (1)
Choose how to capture your document (2): manually or automatically. If you choose manual, select the country of the document you will use (3) and the type of document (4).
You can also enable NFC. If you need information about NFC, you can access it through the information icon (5). To activate NFC capture, activate the button (6).
Once the flow is configured and the document selected, press the button (7) to start the process.
1. Settings button
2. Document capture mode selector
3. Country selector
4. Document selector
5. NFC information button
6. Button to activate NFC
7. Continue button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If you choose automatic capture mode (2), it is not necessary to select the country or document type.
Once the flow is configured, press the button (5) to start the process.
1. Settings button
2. Document capture mode selector
3. NFC information button
4. Button to activate NFC
5. Continue button
{% endcolumn %}
{% endcolumns %}
***
### **Configuration**[](#configuración)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
In Settings there are several parameters that you can expand (2)(3)(6)(9)(17), and enable/disable (4)(5)(7)(8)(10)(11)(12)(13)(14)(15)(16)(18)(19)(20). For example, to choose the document type, allow signing at the end of the onboarding, or security validators.
From here you can log out by scrolling to the bottom of the screen (22).
To go back to the previous screen, press the back icon (1).
1. Back button
2. Country selector
3. Identity document selector
4. Enable/disable geolocation
5. Enable/disable Video Assistance
6. Video Assistance help type selector
7. Enable/disable Onboarding recording
8. Enable/disable signing
9. Signature type selector
10. Enable/disable previous onboarding validation
11. Enable/disable blocklist validation
12. Enable/disable government validation
13. Enable/disable morphological validation
14. Enable/disable NFC validation
15. Enable/disable fingerprint validation
16. Selector for hands for fingerprint reading
17. Enable/disable preview of captured photos
18. Enable/disable saving captured images
19. Enable/disable Passive Liveness
20. Enable/disable advanced Tracking
21. Show additional information
22. Log out
{% endcolumn %}
{% endcolumns %}
***
### **Capture a document**[](#capturar-un-documento)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
First, a tutorial appears explaining how to capture the document.
The animation shows how to interact with the Widget. The text gives details on how to carry out this step correctly.
To continue, press button (2). To go back, press icon (1).
1. Back button
2. Continue button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If you have not previously granted the app camera permissions, a message will appear so you can accept those permissions. Camera access is necessary to capture a document or face, among other things.
1. Deny button
2. Allow access button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Once in the widget, a text appears giving you instructions for the step to perform. In this case, your camera has been activated and you must focus on the front of your document. The document must fit within the frame (3), without the edges of the document extending beyond the frame. If the lighting and sharpness conditions are adequate, the photo will be taken automatically.
If you have any questions or difficulties with this step, press the information button (2) and a tutorial that can help you will open.
To exit the widget without taking the capture, press the icon (1).
1. Close button
2. Information button
3. Frame to align the document
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
This is the document capture tutorial. It is accessed by tapping the information icon (seen on the previous screen). Here you are shown some tips on how to place the document or what to keep in mind for the capture to be taken. You can move through it by swiping right or left (3).
To skip the tutorial, press the button (2). To return to document capture, press the icon (1).
1. Back button
2. Skip button
3. Page indicator
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The widget will show you in real time whether the capture could be taken, or whether there was a problem.
**If the capture was not taken (1)**, retry this step until the widget takes the photo. The information button or error diagnostics can be very helpful for this step.
**If the capture was successful (2)**, a confirmation message will appear. Repeat the same step, this time with the back of your document.
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
*Optional screen. It can be enabled from Settings.*
The widget has captured the document, and this preview screen is shown. Here you must check that the document is fully visible and the data are legible.
If the photo is blurry, or data is hidden or cut off, we recommend pressing the button (2) to retake the photo. A bad capture can lead to a bad interpretation of the data and require repeating the process again.
If the photo is sharp and the data can be read well, press the button (3) to continue to the next step.
To exit and not continue, press the icon (1). Skipping this step will take you to the previous step.
1. Close button
2. Retake button
3. Continue button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Now capture the back of the document. The steps and instructions are the same as for capturing the front of the document.
Once the photo is taken, you will need to check the capture preview to validate the photo or retake it. If it is validated, you will have completed the document capture process.
{% endcolumn %}
{% endcolumns %}
***
### **Scan NFC**[](#escanear-nfc)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The tutorial explains how to scan the NFC chip.
The animation shows how to interact with the Widget. The text gives details on how to carry out this step correctly.
If you need more information about NFC, press the button (2).
To go back, press the icon (1). To continue, press the button (3).
1. Back button
2. NFC information button
3. Continue button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If you press the button for more information about NFC, this screen will be shown.
To close this screen, press the icon (1) or the button (2).
1. Back button
2. Continue button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Once NFC capture has started, a text appears giving instructions on what to do for a correct reading. To cancel the process, press button (1) or button (2).
1. Button to cancel the process
2. Close button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
When the document is in the correct position relative to the device, the data transfer will begin. Keep that position until the transfer ends. To cancel the process, press button (1) or button (2).
1. Button to cancel the process
2. Close button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
In case of an error, it will be reported on this screen.
{% endcolumn %}
{% endcolumns %}
***
### **Capture the face**[](#capturar-el-rostro)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The tutorial explains how to capture a face.
The animation shows how to interact with the Widget. The text gives details on how to carry out this step correctly.
To continue, press button (2). To go back, press icon (1).
1. Back button
2. Continue button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Once in the Widget, a text (2) appears that gives you instructions on how to position yourself, or what you need to keep in mind.
If you follow the instructions correctly, the capture will be done automatically and you will be directed to the next step.
To exit and not continue, you can close the widget by pressing the icon (1).
1. Close button
2. Instruction text
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
*Optional screen. It can be enabled from Settings.*
The Widget has captured the face, and this preview screen is shown. Here you must check that the oval of your face is fully visible and clear.
If the photo is blurry, or there are parts of your face that are covered, we recommend pressing button (2) to retake the photo. A poor capture can lead to a poor interpretation of the data and require repeating the process again.
If the photo is clear, press button (3) to continue with the next step.
To go back, press the icon (1). Skipping this step will take you to the previous step.
1. Back button
2. Retake button
3. Continue button
{% endcolumn %}
{% endcolumns %}
***
### **Capture fingerprints**[](#capturar-huellas-dactilares)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The tutorial explains how to capture fingerprints.
The animation shows how to interact with the Widget. The text gives details on how to carry out this step correctly.
To continue, press button (2). To go back, press icon (1).
1. Back button
2. Continue button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Once started, the camera opens and you must place your fingers together on the marker. Keep your hand within the indicated area and follow the messages that appear on screen: move your fingers closer or farther away, move them slowly to focus, show your fingertips, or use the indicated hand.
If a finger is missing or the fingers are not detected, adjust the position until all of them are visible within the marker. When the capture is ready, keep your fingers still. The app will capture the fingerprints automatically and you will have completed the step.
To go back, press the icon (1).
1. Back button
{% endcolumn %}
{% endcolumns %}
***
### **Results**[](#resultados)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Once all the onboarding steps are finished, the results screen appears. All extracted data are shown, as well as the biometrics recorded and security checks. For example, the photos of the document and the user (1), fingerprint reading, geolocation, or checks against government databases.
At the bottom, by tapping the hyperlink for each result (2)(3)(4)(5)(6)(7), we can access a more detailed version of that specific result.
To finish the onboarding, press the button (8).
1. Captured images
2. See more of the extracted OCR data
3. See more of previous Onboarding
4. See more of blocklist validation
5. See more of government service
6. See more of morphological validation
7. See more of NFC reading
8. Button to finish onboarding
{% endcolumn %}
{% endcolumns %}
***
### **Document signature**[](#firma-de-documento)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If document signing is enabled in Settings, and the onboarding process has been successful, you will be able to sign the document. To start the signing process, scroll to the bottom of the screen and press the button (2). To finish the onboarding without signing, press the button (1).
1. Button to finish onboarding
2. Sign button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Before signing, you must accept the GDPR. To enable the continue button (2), you must reach the end of the GDPR by scrolling the sidebar to the bottom. Once button (2) is enabled, press it to start the signing process. To close or go back, press button (3).
1. Back button
2. Sign button
3. Button to close/go back
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
VideoID needs you to allow access to the camera and microphone to carry out the process. To grant permission each time the app starts, press button (1). To grant permission only this time, press button (2). To cancel permission and exit, press button (3).
1. Button to allow access while using the app
2. Button to allow access only this time
3. Button to cancel access
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The screen shows an oval (2) where you must place your face. The process will start automatically when the face is detected.
To exit the process, press the icon (1).
1. Button to exit the process
2. Oval to place the face
3. Rectangle to place the document
4. Instruction text
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Repeat the same step, this time reading aloud the text that appears at the bottom (3).
After registering the voice, there will be a camera change so you can capture the document.
To exit the process, press the icon (1).
1. Button to exit the process
2. Oval to place the face
3. Instruction text
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The screen shows a rectangle (2) where you must position the front of the document. The process will start automatically when the document is detected.
To exit the process, press the icon (1).
1. Button to exit the process
2. Rectangle to place the document
3. Instruction text
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Repeat the same step, this time showing the back of your document inside the rectangle (2).
To exit the process, press the icon (1).
1. Button to exit the process
2. Rectangle to place the document
3. Instruction text
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If you tap the close icon, this floating window will appear. To finish this process and exit, press the button (2). To cancel this window and continue with the video recording, press (1).
1. Button to cancel
2. Button to finish
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If the video recording is correct, press button (3) to send it and finish. You can repeat the recording by pressing button (2). Press button (1) to close this screen.
1. Close button
2. Button to repeat recording
3. Button to finish
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If the video recording was sent successfully, this screen will appear.
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
If the video recording has failed, this screen will appear. Press button (2) to retry. To close the process and exit VideoID, press the icon (1).
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
***
### **Errors**[](#errores)
#### **Allowed attempts**[](#intentos-permitidos)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
For security reasons, there is a limit on the number of allowed attempts to perform certain actions. If this error appears, it is because you have made X consecutive unsuccessful attempts. You must wait for the time to expire before trying this step again.
By pressing button (2) you go back to the widget to retry this step. If you want to close this screen, press the icon (1).
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
#### **Camera permissions**[](#permisos-de-cámara)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
Camera permission has previously been denied, but the Widget is trying to access it.
By pressing button (2) you will be directed to the app permissions so you can enable them. Otherwise, to close this error screen press icon (1).
1. Close button
2. Button to go to mobile permissions
{% endcolumn %}
{% endcolumns %}
#### **Update the application**[](#actualizar-la-aplicación)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
There is a new version of the application, and it needs to be updated. Usually, this is due to bug fixes or the implementation of improvements.
By pressing button (2) you will be directed to the download page to update the app. Conversely, to close this error screen press icon (1).
1. Close button
2. Refresh button
{% endcolumn %}
{% endcolumns %}
#### **Technical issue**[](#problema-técnico)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
An internal error has occurred in the app and it is necessary to restart the last step for a correct registration.
By pressing button (2) you will retry this step. Otherwise, to close this error screen press the icon (1).
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
#### **Time exceeded**[](#tiempo-superado)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The maximum time for the widget to perform the capture has been exceeded.
The most likely case is that the necessary conditions for the widget to take an adequate photo were not met.
Retry this step following the instructions on screen, or by tapping the information icon (if there is one) to receive tips.
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
#### **Problems reading the document**[](#problemas-al-leer-el-documento)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The device sensor does not detect NFC. This may be due to:
* The document is too far from the device. We recommend bringing the document and the device together so that they touch.
* The document and the device are together, but it is not detected: slide one slightly over the other until the device detects the document. Depending on the device brand, the sensor is located in a different area. For this reason, we recommend bringing the document to the back of the device and moving it around until you find the internal sensor.
Retry this step following the instructions on screen, or by tapping the information icon (if there is one) to receive tips.
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
This error appears when data transfer via NFC has started, but the connection was lost during transfer. It may be due to:
* The device or the document moved while the transfer was taking place. Once it starts loading, keep that position until it finishes.
Retry this step following the instructions on screen, or by tapping the information icon (if there is one) to receive tips.
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
#### **The document has glare**[](#el-documento-tiene-brillos)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The document has glare that covers the data, and the widget cannot take the photo because it cannot read all the data correctly.
Retry this step following the instructions on screen, or by tapping the information icon (if there is one) to receive tips.
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
#### **Multiple chips**[](#varios-chips)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
This error appears when, in addition to NFC, it is detecting other chips around it. It may be due to:
* The document is together with other documents: move the selected document you have chosen for the onboarding away from the rest of the documents.
Retry this step following the instructions on screen, or by tapping the information icon (if there is one) to receive tips.
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
#### **Blurry image**[](#imagen-borrosa)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The image is not sharp. It may be due to:
* The lens is dirty and the photo comes out blurry
* There is movement in the image. The camera and the image should remain as still as possible.
* There is not enough light in the environment for a clear capture of the image.
By pressing button (2) you will retry this step. Otherwise, to close this error screen press the icon (1).
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
#### **Inactivity**[](#inactividad)
{% columns %}
{% column width="41.66666666666667%" %}
{% endcolumn %}
{% column %}
The application does not detect movement. This may be because the widget was started, but has been inactive for a while.
Retry this step following the instructions on screen, or by tapping the information icon (if there is one) to receive tips.
1. Close button
2. Retake button
{% endcolumn %}
{% endcolumns %}
***
### **Frequently asked questions (FAQ)**[](#preguntas-frecuentes-faq)
* **What is a digital Onboarding?**\
Process in which companies onboard their customers and users securely and quickly thanks to biometrics.
* **What is NFC?**\
\&#xNAN;*Near Field Communication*. Wireless communication technology that facilitates the exchange of data between devices. It is frequently used in the financial sector.
* **What is OCR?**\
Optical Character Recognition. It is a process that allows extracting the text contained in an image or a document.
* **Error during document capture, what can I do?**\
If during document capture you have not managed to obtain a successful capture, it is recommended to follow the suggestions below:
* Avoid excessive glare and shadows to obtain a clear, sharp image.
* Use a uniform background that allows the document to stand out from the image.
* Do not cover the edges of the document with your fingers when capturing the image.
* Make sure the document is well focused and framed within the image.
* Check that the text in the image is legible and well lit.
* Make sure the captured image is sharp and centered to obtain the best results.
* **Error during face capture, what can I do?**\
If during face capture you have not managed to obtain a successful capture, it is recommended to follow the suggestions below:
* Avoid excessive glare and shadows to obtain a clear, sharp image.
* Use a uniform background so that the image stands out.
* Do not cover parts of the face with hair, masks, or dark glasses.
* Make sure the face is centered and inside the circle.
* Check that proper lighting is maintained and avoid dark places.
* Make sure the captured image is sharp and centered to obtain the best results.
***Most common errors/issues and how to solve them***
* **Connection error**: A connection error is displayed and does not allow you to continue.
* **Service outage error**: A connection error is displayed and does not allow you to continue.
There is monitoring of production services to notify these problems and resolve them as quickly as possible.
* **Document is not captured (Timeout 10 seconds)**: Previous checks to perform:
* Validate that when trying to capture the document, glare does not affect it and no fields on the document are being covered.
* Validate that the correct country has been selected.
* Validate that the correct document type has been selected (a distinction is made between identity documents and foreigner documents).
If the document is not modeled, you need to submit the request to the Sales team to include it in future versions.
* **No selfie captured:** Previous checks to perform:
* Validate that the lighting conditions allow the face to be clearly visible.
* Validate the messages about the face's distance from the camera.
* **Biometric authentication error**: Biometric validation can return the following error results:
* Negative biometric authentication
* If a positive result is expected, validate:
* That the selfie taken is clear and has no occlusions that could cause problems.
* That the photo taken of the document has no glare and is not blurry (this should be validated while the document is being captured).
* False rejections: false rejections can occur for the following reasons:
* The photo of the document and the selfie are very different (too much time has passed, major changes in the face, image quality, occlusions).
* Positive biometric authentication
* If a negative result is expected:
* False acceptances:
* If tests are being carried out among relatives (twins, siblings, parents-children, cousins, etc.), it is recommended to submit the request to Sales so that a higher security threshold can be applied, appropriate for this type of environment.
* Biometric authentication not performed
* Validate that the photo taken of the document has no glare, is not blurry, and has no occlusions (for example: holograms, reflections).
* **liveness check not passed**: The liveness check can present the following errors:
* liveness check NOT passed. If a positive result is expected, validate:
* That there are no other people (faces) in the selfie, the technology rejects the liveness check if there is more than one face in the image
* That there are no backlights or screens with glare in the background
* That the eyes are not closed
* That sunglasses are not being worn
* Troubleshooting:
* Avoid using glasses and occlusions
* Find a suitable background, without screens or glare
* Avoid having faces in the background when taking the selfie
* If there is no way to pass the liveness check, there is the option to disable this validation from the configuration screen
* liveness check passed. If a negative result is expected:
* False acceptances:
* If tests against presentation attacks are being carried out (screens, printed photos, masks), it is recommended to submit the request to Sales so that a higher security threshold can be applied, appropriate for this type of environment.
* **Incorrect OCR (personal data)**: OCR quality issues are usually associated with poor document captures (blurry, glare, occlusions, etc.). If recurring issues are detected in the fields shown, Sales should be contacted to process strengthening of the document modeling.
* **Geolocation**: Geolocation validation is performed against the document issuer country.
* **Face matching**: The face matching evaluation is performed by comparing the common data between the front and back. In case of an error in the expected result, you can check in the OCR detail whether the fields are being captured and labeled correctly.
We have experience that in new documents (not yet analyzed in detail), errors may occur in this diagnosis due to incorrect field labeling. You should contact Sales to make the necessary adjustments.
* **Previous Onboarding**: Previous onboarding validation is performed against previous successful onboardings carried out in the same tenant.
For efficiency reasons, the previous onboarding database is periodically emptied, so it is recommended to perform an onboarding before enabling the functionality.
* **Blocklist**: Blacklist validation is performed against the face database created in the tenant from the platform, through the Anti-fraud - Rules module.
* **Government service**: Government service validation is only available in specific countries; the updated country list is maintained by Sales.
The availability of the government service depends on the service provider itself, so its status cannot be guaranteed.
* **NFC reading**: Currently, the NFC tab shows all the data collected from the chip and, if the document allows it, the result of biometric validation between the selfie and the photo stored on the chip.
