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

# Document

**Document Capture Widget**

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

SelphID is a Widget that allows capturing and validating a user's Identity document.

As a result, the document's authenticity is verified through algorithms and security protocols. All extracted data can be consulted at any time from Facephi Platform.

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

The Widget is compatible with Android 6 or higher.

### **Capture a document**[​](#capturar-un-documento) <a href="#capturar-un-documento" id="capturar-un-documento"></a>

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

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

{% column %}
The first screen is a tutorial that explains how to do Document Capture.

The animation shows how to interact with the widget. The text gives details on how to perform this step correctly.

To continue, tap button (2). To go back, tap icon (1).

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

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

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

{% column %}
If you have not previously granted the app camera permissions, a message will appear so you can accept those permissions. Camera access is necessary for document or face captures, among other things.

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

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

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

{% column %}
Once in the widget, a text appears giving you instructions for the step to follow. In this case, your camera has been activated and you must focus on the front of your document. The document must fit within the frame (3), without the edges of the document extending beyond the frame. If lighting and sharpness conditions are adequate, the photo will be taken automatically.

If you have doubts or difficulties with this step, tap the information button (2) and a tutorial will open to help you.

To exit the widget without taking the capture, tap icon (1).

1. Close button
2. Information button
3. Frame to align the document
   {% endcolumn %}
   {% endcolumns %}

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

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

{% column %}
This is the document capture tutorial. You access it by tapping the information icon (seen on the previous screen). Here you will see some tips on how to place the document or what to keep in mind so the capture can be performed. You can move by swiping right or left (3).

To skip the tutorial, tap button (2). To go back to document capture, tap icon (1).

1. Back button
2. Skip button
3. Page indicator
   {% endcolumn %}
   {% endcolumns %}

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

<figure><img src="/files/ad98a5570d0ed586d2dc97907fe9c43e4dac70c8" alt=""><figcaption></figcaption></figure>

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

{% column %}
The widget will show you in real time whether the capture could be made or whether there was a problem.

**If the capture was not made (1)**, retry this step until the widget takes the photo. The information button or error diagnostics can be very helpful for this step.

**If the capture was successful (2)**, a confirmation message will appear. Repeat the same step, this time with the back of your document.
{% endcolumn %}
{% endcolumns %}

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

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

{% column %}
*Optional screen. It can be enabled from Settings.*

The widget has captured the document, and this preview screen is shown. Here you must check that the document is fully visible and that the data are readable.

If the photo is blurry, or there is data covered or cut off, we recommend tapping button (2) to retry the photo. A bad capture can lead to misinterpretation of the data and having to repeat the process again.

If the photo is sharp and the data are readable, tap button (3) to continue to the next step.

To exit and not continue, tap icon (1). Skipping this step will take you to the previous step.

1. Close button
2. Retry button
3. Continue button
   {% endcolumn %}
   {% endcolumns %}

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

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

{% column %}
Now capture the back of the document. The steps and instructions are the same as for capturing the front of the document.

Once the photo has been taken, you will have to check the capture preview to validate the photo or retake it. If it is validated, you will have completed the document capture process.
{% endcolumn %}
{% endcolumns %}

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

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

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

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

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

Tapping button (2) takes you back to the widget to retry this step. If you want to close this screen, tap icon (1).

1. Close button
2. Retry 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="/files/55e1431969f3e3c7d76993cbdbf4bf81b31ae641" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

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

Tapping button (2) will take you to the app permissions so you can enable them. Otherwise, to close this error screen tap icon (1).

1. Close button
2. Button to go to phone permissions
   {% 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="/files/b3a462baf75a1b443c13a41695108928372c465c" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
A new version of the application is available, and it needs to be updated. Usually, for bug fixes or feature improvements.

Tapping button (2) will take you to the download page to update the app. Otherwise, to close this error screen tap icon (1).

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

#### **Technical issue**[​](#problema-técnico) <a href="#problema-tecnico" id="problema-tecnico"></a>

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

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

{% column %}
An internal error has occurred in the app and it is necessary to restart the last step for a correct record.

Tapping button (2) will retry this step. Otherwise, to close this error screen tap icon (1).

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

#### **Timeout exceeded**[​](#tiempo-superado) <a href="#tiempo-superado" id="tiempo-superado"></a>

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

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

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

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

Retry this step following the instructions on screen, or by tapping the information icon (if any) to receive tips.

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

#### **Inactivity**[​](#inactividad) <a href="#inactividad" id="inactividad"></a>

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

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

{% column %}
The application does not detect movement. This may be because the widget started, but has been inactive for some time.

Retry this step following the instructions on screen, or by tapping the information icon (if any) to receive tips.

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

#### **The document has glare**[​](#el-documento-tiene-brillos) <a href="#el-documento-tiene-brillos" id="el-documento-tiene-brillos"></a>

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

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

{% column %}
There is glare on the document that covers the data, and the widget cannot take the photo because it cannot read all the data correctly.

Retry this step following the instructions on screen, or by tapping the information icon (if any) to receive tips.

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