Qué es Identity Link
Una verificación es un enlace. Lo creás, lo compartís y la persona lo abre en el navegador que ya tiene: nada que instalar de su lado, ningún SDK que publicar del tuyo. Dentro de esa sesión fotografía su documento de identidad y, en el tipoFULL FLOW, completa la prueba de vida. VU lee el documento con OCR, compara la cara en vivo contra la foto impresa en él, revisa ambas capturas contra intentos de spoofing y te devuelve un único resultado consolidado.
Lo que la persona nunca hace es mandarte la foto de su documento por una app de mensajería. Las capturas viajan dentro de la sesión del propio enlace, y el registro que producen vive exactamente lo que duran las dos ventanas de vencimiento configuradas en tu cuenta. Después de eso la API responde 410 para el registro y 404 para sus imágenes.
La API es una función paga. Solo Premium y Pro pueden obtener un token: en Basic,
POST /oauth/token responde 401 invalid_client. El cupo de verificaciones, las ventanas de vencimiento, la personalización y la precisión de la ubicación cambian según el plan. Mirá Planes.Flujo de integración
El proceso consta de cuatro etapas principales. Sigue la secuencia para entender cómo interactúan tu backend, la API de VU y el dispositivo del usuario final.1
Autenticación
Tu backend obtiene un token Bearer mediante OAuth2 client credentials con tu
clientId y clientSecret. El token tiene una duración de 3600 segundos.2
Creación del enlace
Llamas a
POST /links para generar un vínculo de un solo uso. Recibes linkUrl, linkId y verificationId.3
Usuario completa la verificación
Compartes
linkUrl con el usuario por email, WhatsApp, SMS o QR. El usuario captura el frente y reverso del documento, y en flujos FULL FLOW también realiza la prueba de vida facial.4
Recepción de resultados
Recibes eventos de webhook en tiempo real o consultas el estado mediante polling. Finalmente lees los datos extraídos con
GET /verifications/{id}.Arquitectura del flujo
Tipos de flujo disponibles
VU Identity Link ofrece dos modalidades según tus necesidades de verificación:FULL FLOW
Captura documental + prueba de vida facial anti-spoofing. Ideal para onboarding digital de alta seguridad.
ID ONLY
Solo captura y extracción de datos del documento. Útil para validaciones rápidas donde no se requiere biometría.
Flujo adaptativo
Desde la versión 2.2.0, un LinkFULL FLOW puede activar el flujo adaptativo con el campo adaptiveFlow. Cuando el cliente ya se verificó antes, el Link se resuelve en una rama de solo selfie y omite la captura documental. La rama efectiva se expone como method (FACE o DOCUMENT) en el endpoint de estado.
El flujo adaptativo necesita externalUserId para localizar la verificación previa. Si no lo conoces al crear el Link, el usuario puede aportar su email durante el flujo con PATCH /verifications/identify. Consulta Enlaces de verificación.
URL base y versión
Todas las llamadas usan la siguiente URL base:Próximos pasos
Explora cada sección de la integración para implementar paso a paso:Autenticación
Obtén tokens Bearer con OAuth2 client credentials.
Enlaces de verificación
Crea y gestiona enlaces de verificación de un solo uso.
KYC
Lee resultados, datos extraídos y estado de verificaciones.
Prueba de Vida
Entiende la biometría facial y anti-spoofing.
Webhooks
Recibe notificaciones en tiempo real de cada evento.
Errores
Maneja códigos de error y reintentos.