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

# Face

**Widget face capture v.6.X.X**

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

Face onboarding is a remote, online registration process that is done the first time a user accesses a service or product.

To carry out the registration, the face is automatically captured to obtain the biometric pattern for identity verification.

### **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, since it works within a web address. 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 begin, a message appears asking for the necessary permissions to carry out the process.

To continue, press button (1). To cancel the 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 giving you instructions on how to position yourself, or what you need to keep in mind.

This message updates 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 happen automatically and you will be taken to the next step.

If you want to close the process, press the 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 correctly positioned, it will return to the previous state with help messages.

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

1. Button to close the process
2. Information 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 has been captured, a preview screen will appear (if it has been enabled in Settings). Here you must check that the face is fully visible and well lit.

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

If the photo is sharp, press the button (4) to continue to 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 find some tips on how to position your face, or what things to keep in mind so the capture is completed successfully. There are 3 tips in total.

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

To exit the Widget without capturing, press the 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>

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

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

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

{% column width="50%" %}
You can try again by pressing button (2).

1. Log out button
2. Retry button
   {% endcolumn %}
   {% endcolumns %}

#### **Time 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 capture has been exceeded.

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

Retry this step by following the instructions on screen and pressing the 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 %}

#### **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 should wait a moment for the error to be resolved.

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