> 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/autenticacion-usuarios-registrados/editor-1/mobile/android/widgets/rostro.md).

# Face

**Face capture Widget**

### **Introduction**[](#introducción) <a href="#introduccion" id="introduccion"></a>

Selphi is a biometric solution that allows you to capture and validate a user's face.

As a result, the authenticity of the document and the user is verified using algorithms and security protocols. All extracted data can be consulted at any time from our platform.

### **Requirements and installation**[](#requisitos-e-instalación) <a href="#requisitos-e-instalacion" id="requisitos-e-instalacion"></a>

Facephi Onboarding is compatible with Android 6 or higher.

### **Capture the face**[](#capturar-el-rostro) <a href="#capturar-el-rostro" id="capturar-el-rostro"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-21c527c1223735be5e6fe3efd60fa6ad4be8fc4b%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
The first screen is a tutorial that explains how to perform the face capture.

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%" %}

<figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-7d5665c5ae73d74a478102064c3ea5cb42073154%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Once in the Widget, a text (2) appears giving 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 taken to the next step.

If you do not want to perform this step, you can close the Widget by pressing icon (1).

1. Close button
2. Help message
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-397e6555710753b8f2ba34b03da3979c99b71852%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
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 parts of your face are covered, we recommend pressing button (2) to retake the photo. A poor capture can lead to a poor interpretation of the data and having to repeat the process again.

If the photo is clear, press button (3) to continue with the next step.

To leave this step, press icon (1). Skipping this step will take you to the previous step.

1. Back button
2. Retake button
3. Continue button
   {% endcolumn %}
   {% endcolumns %}

### **Errors**[](#errores) <a href="#errores" id="errores"></a>

#### **Time expired**[](#tiempo-superado) <a href="#tiempo-superado" id="tiempo-superado"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-80db7d27d09607a5a825b369e965389a7bd604c0%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
The waiting time for the Widget to capture has been exceeded. Once the camera starts, you have X seconds to complete the corresponding step. If not, this message will appear so you can try again.

By pressing button (2) you return to the Widget to retry the previous step. If you want to close this screen, tap icon (1).

1. Close button
2. Retake button
   {% endcolumn %}
   {% endcolumns %}

#### **Internet connection**[](#conexión-a-internet) <a href="#conexion-a-internet" id="conexion-a-internet"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-6991108d5e4cca9df72dfc41b833bf3ddfbfe933%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
There was an error with your internet connection.

By pressing button (2) you return to the Widget to retry the previous step. If you want to close this screen, tap icon (1).

1. Close button
2. Retake button
   {% endcolumn %}
   {% endcolumns %}

#### **Update the application**[](#actualizar-la-aplicación) <a href="#actualizar-la-aplicacion" id="actualizar-la-aplicacion"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-8fcfa648aa790c68002de29043d6cf331a1bda05%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
There is a new version of the application, and it is necessary to update it. Usually, to fix bugs or implement improvements.

By tapping the button (2) you will be directed to the download page to update the app. Otherwise, to close this error screen press icon (1).

1. Close button
2. Button to update app
   {% endcolumn %}
   {% endcolumns %}

#### **Camera permissions**[](#permisos-de-cámara) <a href="#permisos-de-camara" id="permisos-de-camara"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-2d2b4136865dc0030374b8094bf9aa3e09db59e4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
Camera permission has previously been denied, but the Widget is trying to access it.

By tapping the 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 permissions
   {% endcolumn %}
   {% endcolumns %}

#### **Allowed attempts**[](#intentos-permitidos) <a href="#intentos-permitidos" id="intentos-permitidos"></a>

{% columns %}
{% column width="41.66666666666667%" %}

<figure><img src="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-a07423cc422c6e315de09cd1e099869cac6563d2%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
For security, there is a limit on the number of attempts allowed to perform certain actions. If this error has appeared, it is because you have made X unsuccessful attempts in a row. You must wait until the time ends before trying this step again.

By pressing button (2) you return to the Widget to retry this step. If you want to go back, press icon (1).

1. Close button
2. Retake button
   {% endcolumn %}
   {% endcolumns %}