Cuándo se activa la prueba de vida
La biometría facial solo se incluye en el tipo de flujoFULL FLOW. Si creas un Link con tipo ID ONLY, el usuario solo capturará el frente y reverso del documento, sin prueba de vida.
Rama adaptativa: solo selfie
Desde la versión 2.2.0, un LinkFULL FLOW con flujo adaptativo puede resolverse en una de dos ramas para un cliente que ya se verificó antes:
La rama se resuelve en el servidor y se persiste una sola vez. Puedes leerla en
GET /verifications/{id}/status?include=operationGuid, en el campo method. La prueba de vida se ejecuta en ambas ramas: lo que la rama FACE omite es la captura del documento, nunca el control biométrico.
Anti-spoofing en Identity Link
El sistema aplica controles anti-spoofing en dos capas:- Anti-spoofing facial: detecta intentos de suplantación con fotos, videos, máscaras o pantallas.
- Anti-spoofing documental: verifica que el documento capturado no sea una foto de pantalla o una copia impresa.
Estado de los servicios de anti-spoofing
Respuesta de ejemplo
El endpoint devuelve 200 cuando el servicio está operativo y 503 cuando no lo está, con el mismo esquema en ambos casos. Si algún indicador muestra
DOWN, las verificaciones que dependan de ese servicio fallarán hasta que se restaure.
Interpretación de resultados
Durante el flujo FULL FLOW, recibirás eventos de webhook específicos para la etapa de registro facial:
El evento final
verification.successful solo se dispara si tanto la captura documental como la prueba de vida pasaron todos los controles.
La verificación no expone puntuaciones biométricas ni banderas separadas de liveness. El resultado consolidado vive en
status (success o failed); cuando falla, errorMessage describe la causa. Consulta también los eventos de webhook granulares para saber en qué etapa se produjo el fallo.Acceso a los frames de la selfie
Puedes recuperar las imágenes capturadas durante la prueba de vida mediante los endpoints de imágenes:images de la verificación: addFront y addBack son las caras del documento, y el array register contiene los frames de la selfie tomados durante la prueba de vida, útiles para auditoría manual o revisión de casos borderline.
Configuración de anti-spoofing a nivel de compañía
La banderaantiSpoofing de tu compañía controla si los controles anti-spoofing están activos. Es un ajuste administrado por VU y de solo lectura para la API: se expone dentro del bloque company de GET /links/{id}.
PATCH /users/me/company no acepta antiSpoofing. Los ajustes de compañía que sí puedes modificar son name, color, logo, linkConfig y verificationConfig. Para cambiar la política anti-spoofing, contacta a tu responsable de cuenta en VU.Si necesitas solo extracción de datos documentales sin verificación facial, crea siempre Links de tipo
ID ONLY. Esto reduce la fricción para el usuario final en casos donde la biometría no es requerida.