> 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 verifies users’ identities using facial biometric technology.

User authentication requires a one-time biometric registration step to verify identity. Once registered, the authentication process involves capturing the user’s face and comparing it with the previously registered image, allowing the user to access the product and/or service.

### **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 you are using a desktop or 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="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-56127bca6c529b3a2aa90fcc57afe905eb220a7f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

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

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

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

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

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

{% column width="50%" %}
Once the process begins, text (2) appears with instructions on how to position yourself and what to keep in mind.

This message updates in real time and provides details about:

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

If the conditions are right, the capture will happen automatically and take you to the next step.

To close the process, tap the icon (1).

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

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

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

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

To close the process, tap the icon (1).

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

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

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

{% column width="50%" %}
Once your face has been captured, a preview screen appears (if enabled in Settings). Check that your face is fully visible and well lit.

If the photo is blurry, cropped, or poorly lit, we recommend repeating this step (3) to retake it and avoid issues later. A poor capture at this step may lead to facial recognition errors later.

If the photo is clear, tap 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 lets you confirm that the image was captured correctly
{% endcolumn %}
{% endcolumns %}

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

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

{% column width="50%" %}
This is the face capture tutorial. It provides tips on how to position your face and what to keep in mind for a successful capture. There are 3 tips in total.

Tap button (3) or (4) to view them. To return to Document Capture, tap button (2).

To exit the Widget without capturing an image, tap 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>

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

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

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

{% column width="50%" %}
The maximum time allowed for the Widget to capture an image has elapsed.

Most likely, the conditions required for the Widget to capture a suitable photo were not met.

Try this step again by following the on-screen instructions and tapping button (3), or, if available, tap the information icon (2) for 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="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-ea692e2e0b28365da8522c558ea9c6b59c9cc3e3%2Fcamera.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

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

After a few seconds, the message disappears and the previous screen reappears.

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="https://865101184-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-96db696e4c66ce5a205d60f7c6640836ac152f63%2Fface.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
If the camera does not detect a face during face capture, this error message appears. Tap button (1) to close this screen or button (2) to try again.

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

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

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

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

{% column width="50%" %}
This message appears when an internal technical issue occurs. It is usually a temporary error. Wait a moment for the issue to be resolved.

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