# Verificación de edad

#### Descripción general

La **verificación de edad** permite validar si un usuario cumple con el requisito legal o de negocio asociado a una edad mínima (por ejemplo, mayores de 18 años). Este proceso es clave en sectores como fintech, e-commerce, juegos online o apuestas, donde es obligatorio restringir el acceso a menores.

***

### Servicios técnicos necesarios

**Frontend (SDKs)**

SDKs para captura de documentos y biometría facial, compatibles con:

* Android / iOS (nativo)
* Web (JavaScript)
* Frameworks híbridos (Flutter, React Native, Cordova)

> 🔗 [Acceder a la documentación de SDKs Frontend →](https://facephi.github.io/sdk-mobile-documentation/es/)

**Requisitos de licenciamiento:**

* **Web:** Dominio o puerto de localhost
* **Mobile:** Package name (Android) / Bundle ID (iOS)

**Backend (vía API REST)**

| Servicio                                     | Endpoint                                                          | Descripción                                                                            |
| -------------------------------------------- | ----------------------------------------------------------------- | -------------------------------------------------------------------------------------- |
| **Validación del documento de identidad**    | `POST /documentValidation/v2`                                     | Extrae la fecha de nacimiento desde un documento válido                                |
| **Evaluación lógica**                        | Middleware / Lógica del cliente                                   | Determina si la edad cumple con el umbral deseado (ej: >= 18 años)                     |
| **Validación con registro civil (opcional)** | `POST /civilValidation`                                           | Confirma edad con datos oficiales si se requiere validación reforzada                  |
| **Liveness y comparación facial (opcional)** | `POST /evaluatePassiveLivenessToken` + `POST /authenticateFacial` | Asegura que el rostro capturado coincide con el del documento, evitando suplantaciones |

> 🔗 [Ver documentación de APIs →](https://docs.identity-platform.io/)

***

### Flujo técnico recomendado

1. **Captura del documento (DNI, pasaporte, etc.)**
2. **Extracción de la fecha de nacimiento (via `documentValidation/v2`)**
3. **Evaluación del campo edad (>= 18)**
4. **(Opcional) Validación de liveness + selfie + comparación facial (1:1)**
5. **(Opcional) Validación cruzada con registro civil**
6. **Devolución de resultado: apto / no apto por edad**

***

### Arquitectura de referencia

> Diagrama funcional y arquitectura estándar de integración: \[enlace al diagrama] *(a incluir en Confluence o embed)*

* SDK Front → Middleware → `documentValidation` → Evaluación lógica → (Opcionales: `civilValidation`, biometría)

***

### Consideraciones técnicas

* Asegurar que el documento capturado contenga la fecha de nacimiento legible
* Evitar falsificación combinando con prueba de vida + comparación facial
* Ajustar el umbral de edad según normativa del país o sector
* La validación contra el registro civil puede no estar disponible en todos los países

***

### Preguntas frecuentes (FAQ)

**¿Se puede usar solo la fecha del documento sin selfie?**\
Sí, aunque para mayor seguridad se recomienda usar biometría facial.

**¿Qué pasa si el usuario falsifica el documento?**\
La validación morfológica y el análisis de liveness reducen este riesgo.

**¿Cómo saber si la fecha de nacimiento es fiable?**\
Puede reforzarse con `civilValidation` cuando esté disponible.

***

#### Casos relacionados

* Onboarding de nuevos usuarios (donde hay requisitos legales de edad)
* Autenticación con validación de edad (para servicios restringidos)
* Detección de fraude (cuando se detectan intentos de falsear edad)

***

#### Descarga de recursos

* SDKs y ejemplos: \[repositorio GitHub / portal privado]
* Documentación técnica completa por SDK: \[enlace]
* Diagrama funcional editable: \[enlace a Figma o PDF]

***

Esta guía te permite implementar validaciones de edad precisas, adaptables a marcos regulatorios, y reforzadas con biometría y conexiones oficiales cuando sea necesario.
