> 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/widgets/rostro.md).

# Face

**Face capture Widget**

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

Selphi is a biometric solution that allows capturing and validating a user's face.

As a result, the authenticity of the document and the user is checked through 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 face capture.

The animation shows how to interact with the Widget. The text gives details on how to do 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 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 will take you 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 should check that your face oval 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 to the next step.

To exit 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 exceeded**[​](#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. Otherwise, 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, press 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, press icon (1).

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

#### **Update the app**[​](#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 %}
A new version of the app exists, and it is necessary to update it. Usually, 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. Otherwise, to close this error screen, press icon (1).

1. Close button
2. Update app button
   {% 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 pressing button (2), you will be taken 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 allowed attempts to perform certain actions. If this error has appeared, it is because you have made X consecutive unsuccessful attempts. You must wait for the time to end 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 %}