> 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/productos/editor-1.md).

# Facephi Onboarding

### **¿Qué resuelve este producto?**

Permite registrar nuevos usuarios de forma remota, segura y sin fricciones. El proceso combina captura documental, biometría facial y validaciones en tiempo real.

### **Integración Saas**

**SDKs necesarios**

* SDK Frontend (Web o Mobile): captura de rostro y documento
* [Documentación Mobile SDK](/sdks/sdk-mobile.md)
* [Documentación Web SDK](/sdks/sdk-web.md)

**Servicios backend necesarios (API REST)**

* Validación de prueba de vida y comparación facial: `POST /v2/identity`
* Extracción OCR de documento:
  * Mobile: `POST /extractDocumentData`
  * Web: `POST /extractDocumentDataWeb`
* Validación de documento:
  * Por morfología: `POST /documentValidation/v2`
  * Contra registro civil: `POST /civilValidation`
* [Documentación API Rest](/api-rest/identity-api.md)

**Otros servicios**

* Validación de onboarding duplicado (opcional): `POST /blacklist`

### **Flujo técnico sugerido**

1\. Componente SelphID (escaneo de documento)

* Realizar la captura del documento mediante el widget SelphID (Web o Mobile).

2\. Componente Selphi (captura del rostro)

* Realizar la captura facial mediante el widget Selphi (Web o Mobile).
* Consumir los siguientes endpoints en este orden:
  * /documentValidation/v2\
    Enviar la imagen completa con contexto para validar la morfología del documento.
  * /extractDocumentDataWeb o /extractDocumentData\
    Obtener los datos OCR extraídos del documento para su procesamiento.
  * /v2/identity

    Realiza la prueba de vida y la comparacion de la selfie contra la imagen del documento en un único llamado.

#### **Requisitos y licencias**

**Frontend**

* Web: URL / puerto
* Mobile: package name o bundle ID

**Backend**

* api-key para el consumo de la API

## Recomendaciónes técnicas

### Persistencia de plantilla biométrica

Es requisito obligatorio que el cliente persista la plantilla biométrica (templateRaw) generada mediante el widget Selphi durante el flujo de onboarding o enrolamiento.

Esta plantilla es un elemento esencial, ya que será utilizada posteriormente en los flujos de autenticación biométrica facial. Su correcta conservación garantiza la continuidad y efectividad del proceso de validación de identidad en futuras sesiones.

Se recomienda almacenar esta información de forma segura y cifrada, cumpliendo con las normativas de protección de datos personales y políticas internas del cliente.

### **FAQs**

* ¿Qué diferencia hay entre validación morfológica y por Registro Civil?

La validación morfológica se utiliza en aquellos países donde no existen bases de datos gubernamentales biométricas y/o de datos disponibles para la verificación de identidad. Su objetivo principal es determinar la autenticidad de los documentos presentados, mediante el análisis de sus características físicas y visuales. Adicionalmente, este tipo de validación se emplea para la comprobación de documentos de identificación tales como pasaportes y licencias de conducir.

* ¿Es obligatorio usar ambas validaciones de documento?

No es obligatorio utilizar ambas validaciones de documento. Sin embargo, se recomienda que al menos una de las dos validaciones esté habilitada, con el fin de asegurar la veracidad y autenticidad del documento presentado.\
No obstante, podrán existir requerimientos de negocio, regulatorios o de riesgo que determinen la necesidad de utilizar ambas validaciones de manera conjunta. Por ejemplo, cuando no se aceptan presentaciones de pantalla o copias digitales del documento, se vuelve mandatorio el uso de la validación morfológica para garantizar la autenticidad del documento físico.

***

#### Glosario y conceptos clave

* **Prueba de vida pasiva:** La prueba de vida (Liveness) en Facephi es un mecanismo de seguridad biométrica que permite verificar que la persona que interactúa con el sistema es un ser humano real, está físicamente presente y no se trata de una imagen, video, máscara o contenido sintético.

  Su objetivo principal es prevenir ataques de suplantación de identidad, tales como el uso de fotografías impresas, videos pregrabados o intentos de fraude más sofisticados, incluyendo deepfakes, durante los procesos de verificación y autenticación biométrica.
* **Matching facial:** En el flujo de onboarding, el matching facial consiste en la comparación de la imagen selfie capturada en tiempo real con la imagen del rostro contenida en el frente del documento de identidad presentado por el usuario, con el objetivo de verificar que ambas imágenes corresponden a la misma persona.

  Este proceso permite confirmar que el usuario que realiza el onboarding es el titular legítimo del documento, reforzando la verificación de identidad y reduciendo el riesgo de suplantación.