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

# Face

**Face capture Widget v.5.33.0**

### **Introduction** <a href="#introduccion" id="introduccion"></a>

Face authentication is a process that allows user identity to be verified through facial biometric technology.

To carry out user authentication, a single prior biometric registration step is required to verify identity. Once registered, the authentication process involves capturing the face, which, compared with the previously registered one, will allow the user to access the products and/or services.

### **Requirements and installation** <a href="#requisitos-e-instalacion" id="requisitos-e-instalacion"></a>

To use Facephi Authentication, you must have a compatible browser on your device, whether on a computer or on a mobile device. The compatible operating systems and browsers are:

* Windows, macOS, Android, iOS.
* Mozilla Firefox, Google Chrome, Opera, Safari.

### **Face capture** <a href="#captura-de-rostro" id="captura-de-rostro"></a>

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

<figure><img src="/files/40d6d09c2ad73e34ba4d7f72b67a08da3e6a83fa" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
When you start, a message appears asking for the permissions needed to carry out the process.

To continue, press button (1). To cancel permission and not continue, press button (2).

1. Button to allow access
2. Button to cancel access
   {% endcolumn %}
   {% endcolumns %}

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

<figure><img src="/files/63d9e49bbe847dda9d600202f2a6e9cea926feaa" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Once the process starts, a text (2) appears that gives you instructions on how to position yourself, or what you need to keep in mind.

This message is updated in real time and will give you details about:

* Distance: close, far.
* Framing: outside the circle, rotated.
* Movement
* Lighting

If the proper conditions are met, the capture will be done automatically and you will be taken to the next step.

If you want to close the process, press icon (1).

1. Button to close the process
2. Help message
   {% endcolumn %}
   {% endcolumns %}

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

<figure><img src="/files/befab02501232f240256688d5cc72d57f629329b" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
When your position and the conditions are correct, the circle (2) changes shape and color. If you are not positioned correctly, it will return to the previous state with help messages.

If you want to close the process, press icon (1).

1. Button to close the process
2. Informational circle for the process status
3. Help message
   {% endcolumn %}
   {% endcolumns %}

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

<figure><img src="/files/1174909d755e141394ff1dc1aa73807c9bf9253e" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Once the face capture has been completed, a preview screen will appear (if enabled in Settings). Here you must check that the face is fully visible and well lit.

If the photo is blurry, cut off, or poorly lit, we recommend retrying this step (3) to take the photo again and avoid future errors. A poor capture at this step may cause future facial identification errors.

If the photo is sharp, press button (4) to continue with the next step.

1. Button to close the process
2. Information button
3. Retry button
4. Continue button

The preview is used to confirm that it has been captured correctly
{% endcolumn %}
{% endcolumns %}

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

<figure><img src="/files/b6b9d4f8498781e2d8f247adcda446b52844c521" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
This is the face capture tutorial. Here you will see some tips on how to position your face, or what things to keep in mind so that the capture is successful. There are a total of 3 tips.

To see them, press button (3) or (4). To go back to document capture, press button (2).

To exit the Widget without capturing, press icon (1).

1. Button to close the process
2. Back button
3. Previous button
4. Next button
   {% endcolumn %}
   {% endcolumns %}

### **Errors** <a href="#errores" id="errores"></a>

#### **Timeout exceeded** <a href="#tiempo-superado" id="tiempo-superado"></a>

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

<figure><img src="/files/65cd24505b89d6a323daae51f572415245f92dc3" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
The maximum time for the Widget to perform the capture has been exceeded.

The most likely case is that the conditions necessary for the Widget to take a proper photo were not met.

Retry this step by following the instructions shown on screen and pressing button (3), or, if available, pressing the information icon (2) to receive tips.

1. Button to close the process
2. Information button
3. Retry button
   {% endcolumn %}
   {% endcolumns %}

#### **Camera permissions** <a href="#permisos-de-camara" id="permisos-de-camara"></a>

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

<figure><img src="/files/ce84e57784c891d73f9d99386913dcb4b98a6f4e" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Previously, camera permission was denied, but the Widget is trying to access it.

After a few seconds the message will disappear and you will return to the previous screen.

1. Button to close the process
   {% endcolumn %}
   {% endcolumns %}

#### **Face not detected** <a href="#rostro-no-detectado" id="rostro-no-detectado"></a>

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

<figure><img src="/files/7b9708dd797893c5bae58c5ad32764578981888a" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
If no face is detected by the camera during face capture, this error message will appear. Press button (1) to close this screen, or button (2) to retry.

1. Button to close
   {% endcolumn %}
   {% endcolumns %}

#### **Technical issues** <a href="#problemas-tecnicos" id="problemas-tecnicos"></a>

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

<figure><img src="/files/d1d64c414e9c495276b5ba91ab265345ce7a02a9" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
This message appears when there is an internal technical issue. In principle, it is a temporary error. Here we must wait a moment for the error to be resolved.

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