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

# Document

**Document Capture Widget**

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

SelphID is a Widget that allows you to capture and validate a user's Identity document.

As a result, the document's authenticity is checked using 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 iOS 13 devices or later.

### **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/b742c86ab6651dc1cbcba8f0b550712000aa86b8" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

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

The animation shows how to interact with the Widget. The text provides details on how to carry out this step correctly.

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

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

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

<figure><img src="/files/46521edb2a89f22ca774ff38a7e84c69fc0bcc6e" 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. Access to the camera is necessary to capture documents or faces, among other things.

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

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

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

{% column %}
Once in the Widget, a text appears that gives you instructions for the step to perform. 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 sticking out of the frame. If the lighting and sharpness conditions are adequate, the photo will be taken automatically.

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

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

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

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

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

{% column %}
This is the Document Capture tutorial. It is accessed by tapping the information icon (seen on the previous screen). Here you are shown some tips on how to place the document or what things you need to take into account for the capture to be performed. You can move through it by swiping right or left (3) or (4). To skip this screen, tap the button (2).

To return to Document Capture, tap the icon (1).

1. Skip button
2. Back button
3. Page indicator
4. Next button
   {% 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 has been a problem.

* **If the capture was not performed (1)**, retry this step until the Widget takes the photo. The information button or the error diagnostics can be very helpful for this step.
* **If the capture was performed successfully (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/3cd18bd375e6a282675e961747857fa6a6ea94f4" 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 displayed. Here you must check that the document is fully visible and that the data are legible.

If the photo is blurry, or there is data covered or cut off, we recommend that you tap the button (2) to retry 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 sharp and the data are easy to read, tap the button (3) to continue with the next step.

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

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

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

<figure><img src="/files/a1346689c7ae1fbbfff4fe6dccf59ce0fc5833c5" 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 need 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/a666f5a02881784c8435c3fc547dcf4428eb9391" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
For security reasons, there is a limit to the number of 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.

Pressing the button (2) takes you back to the Widget to retry this step. If you want to go back, press the icon (1).

1. Back 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/93f9624d5048308a100284e95f8d91ebf20a51cc" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

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

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

1. Back button
2. Button to go to mobile 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/43b459e1cd6b360953a597325646516ea114d7ff" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
There is a new version of the application, and it needs to be updated. Usually, this is due to bug fixes or the implementation of improvements.

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

1. Back button
2. Button to refresh
   {% endcolumn %}
   {% endcolumns %}

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

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

<figure><img src="/files/2f666afe39458a958987673a7cb977b7911d7743" 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 registration.

By tapping the button (2) you will retry this step. Otherwise, to close this error screen tap the icon (1).

1. Back 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/7054da1c140355c190e075013a02160eabfae512" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}
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 on screen, or by tapping the information icon (if there is one) to get tips.

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

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

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

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

{% column %}
The app does not detect movement. It may be because the Widget was started, but has been inactive for some time.

Retry this step by following the instructions on screen, or by tapping the information icon (if there is one) to get tips.

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

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

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

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

{% column %}
The document has glare, and the Widget cannot take the photo because it cannot read the data correctly.

Retry this step by following the on-screen instructions or tapping the information icon (if available) to receive help.

1. Button to go back
2. Retry button
   {% endcolumn %}
   {% endcolumns %}