Live ID Validation

Añada inicio de sesión biométrico a su aplicación: confirme a un usuario recurrente comparando un selfi en vivo con el rostro de su verificación KYC de Certivant ya validada, y controle el acceso con un simple resultado de coincidencia verdadero o falso.

Live ID Validation convierte la identidad KYC ya verificada de un cliente en un factor de inicio de sesión biométrico. En el momento de iniciar sesión, el usuario se toma un selfi en vivo; Certivant lo compara con su rostro verificado de KYC (la misma canalización de comparación facial y prueba de vida que se usa durante la incorporación) y devuelve un simple matched: true | false con el que usted controla el acceso.

Live ID Validation (esta función) reautentica a un usuario recurrente. Es distinta de la verificación en vivo por videoconferencia (una incorporación asistida por una persona). Función distinta, nombre distinto.

Cómo funciona

graph LR
  A[User starts login] --> B[Your backend mints a session]
  B -->|holds the Identification Key| C[Certivant verifies key, returns sessionToken + captureUrl]
  C --> D[Device opens captureUrl in a WebView]
  D --> E[Selfie -> face match + liveness]
  E --> F[Your backend reads matched]
  F -->|matched true| G[Grant login]
  F -->|matched false| H[Deny / fall back]

La clave de identificación cifrada es su credencial de larga duración, una por perfil. Permanece en su backend: el dispositivo solo tiene un token de sesión de un solo uso y de corta duración (TTL por defecto de 120 s). La clave se sella con AES-256-GCM y una firma Ed25519, de modo que cualquier manipulación de un solo bit se rechaza en el servidor; el token de sesión solo puede hacer una cosa: enviar un selfi para un perfil.

Requisitos previos

Un perfil verificado e inscrito. Un solicitante de KYC se vuelve apto para Live ID cuando su solicitud está APPROVED y Live ID está habilitado para su inquilino. La inscripción es automática en la aprobación: captura el selfi verificado como rostro de referencia.

Live ID habilitado y umbrales. Actívelo en KYC → Configuración → Live ID (liveIdEnabled), donde también define la puntuación mínima de coincidencia facial, si se exige prueba de vida y el TTL de la sesión.

Un plan con capacidad de Live ID. La cuota Live ID Validations / month included de su plan cubre las validaciones gratuitas; a partir de ahí, cada una se factura a su monedero con Price per Live ID Validation (PAYG). Consulte Facturación.

Una clave de identificación por perfil. Emita una en KYC → Live ID → Claves (o mediante la API de claves) para un perfil inscrito. Guárdela en su backend, asociada a su usuario.

Integre en cuatro pasos

Cree una sesión, en el servidor. Cuando un usuario empieza a iniciar sesión, su backend envía la clave de identificación del usuario a Certivant y recibe un sessionToken y un captureUrl.

curl -X POST https://app.certivant.com/api/kyc/public/live-id/sessions \
  -H "Content-Type: application/json" \
  -d '{"key":"livid_…"}'
# → { "sessionToken": "…", "captureUrl": "https://…/live-id/…", "expiresAt": "…" }

Abra la página de captura. Envíe el dispositivo a captureUrl, una página alojada y pensada para móviles que gestiona la cámara, el selfi y la interfaz del resultado. En la web, ábrala en una ventana emergente o con una redirección; en una aplicación móvil, cárguela en un WebView (consulte Incorporación móvil).

Lea el resultado. Suscríbase al webhook live_id.validation.completed (recomendado) o consulte periódicamente GET /api/kyc/public/live-id/sessions/:sessionToken hasta que status sea completed y lea matched.

Controle el inicio de sesión. matched === true → conceda el acceso. false → deniegue o recurra a otro factor. Cada validación completada se mide (y se factura si supera la cuota).

Consulte las formas completas de solicitud y respuesta en la referencia de la API.

Por qué la clave nunca llega al dispositivo

Poner la clave de identificación en el código del cliente permitiría que cualquiera que la extrajera creara sesiones para cualquiera de sus usuarios. En su lugar:

La clave vive en su backend y solo se usa en la llamada servidor a servidor POST /sessions.
El token de sesión que recibe el dispositivo es de un solo uso, de corta duración y está vinculado a exactamente un perfil inscrito. Enviar un selfi es lo único que puede hacer.
Una clave manipulada se rechaza antes de realizar cualquier trabajo (dos controles de integridad independientes: la etiqueta de autenticación GCM y la firma Ed25519).

Facturación

Live ID tiene en cuenta la cuota:

Las validaciones dentro de la cuota incluida mensual de su plan son gratuitas (pero se miden).
Más allá de la cuota, cada validación factura Price per Live ID Validation a su monedero en dólares.
Si la siguiente validación sería PAYG y su monedero no puede cubrirla, POST /sessions devuelve 402 verification_unavailable: el flujo falla de inmediato, antes de que el usuario abra la cámara, para que pueda recargar saldo o recurrir a otra opción.

Las organizaciones en periodo de prueba usan la cuota Trial Live ID Validations / month del plan. El consumo aparece en su registro mensual de uso de KYC.

Siguientes pasos

Referencia de la API: crear sesión, captura, consulta, validación y payload del webhook.
Incorporación móvil: integración con WebView y aplicaciones de ejemplo para iOS, Android y .NET MAUI.