Documentación técnica de VU

Referencia de integración para los productos de identidad de VU. Todo lo que sigue está escrito para quien va a escribir el código: endpoints, contratos, códigos de error y las trampas que aparecen en producción.

La API de VU Identity Link solo está disponible en los planes Premium y Pro. El plan Basic no tiene acceso por API: POST /oauth/token responde 401 invalid_client. Mirá Planes para ver qué incluye cada uno.

VU Identity Link

Verificación de identidad de punta a punta. Enlaces de un solo uso, captura documental, OCR, prueba de vida y flujo adaptativo. Una integración resuelve el trámite completo.OAuth2 · REST · Webhooks

VU Cloud Services

APIs que se integran de a una. ID Analysis lee el documento, Face Analysis compara los rostros, Antispoofing Facial confirma que la selfie es de una persona real y Connection Fingerprint identifica el dispositivo.Api-Key · REST · Sin SDK · Disponible

Qué podés hacer con Identity Link

1. Verificá a cualquiera en tres pasos

Creás un enlace, lo compartís y leés el resultado. POST /links te devuelve un linkUrl que podés mandar por donde ya hablás con tu cliente: email, WhatsApp, SMS o un QR. Sin app que instalar ni SDK que publicar: corre en el navegador que la persona ya tiene.

2. Los documentos de tu cliente no viajan por WhatsApp

Compartís un enlace, no la foto de un documento. El documento y la selfie van directo a VU dentro de la sesión del propio enlace, que es de un solo uso y se cierra con un reloj que vos configurás. Pasada esa ventana la API responde 410 para el registro y 404 para las imágenes, sin importar qué siga guardando la app de mensajería.

3. Pasá a Premium e integrá por API

OAuth2 client credentials, una API REST y webhooks firmados con HMAC-SHA256 para que tu servidor pueda confiar en lo que recibe. Premium sube el cupo a 100 verificaciones por mes y habilita la personalización completa: tu nombre, tu logo y tu color en cada pantalla que ve tu cliente.

4. Pasá a Pro y ajustalo a tus reglas

Soporte configura tu cupo de verificaciones y las dos ventanas de vencimiento en los valores exactos que necesitás, en minutos y no en opciones fijas. Pro también es el único plan que puede correr fuera del SaaS compartido.

5. El cliente que vuelve se verifica con una selfie

El flujo adaptativo lleva al cliente que ya se verificó a una rama de solo cara y saltea por completo la captura documental. El endpoint de estado informa qué rama corrió en method: FACE o DOCUMENT. Disponible desde la versión 2.2.0.

Empezar en cinco minutos

curl -X POST https://api.identity.vu-one.com/api/v1/oauth/token \
  -H "Authorization: Basic $(printf '%s' "$CLIENT_ID:$CLIENT_SECRET" | base64)" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials"

curl -X POST https://api.identity.vu-one.com/api/v1/links \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"type":"FULL FLOW","externalUserId":"cliente-12345"}'

curl "https://api.identity.vu-one.com/api/v1/verifications/$VERIFICATION_ID/status?linkId=$LINK_ID"

El endpoint de status es público y exige el parámetro linkId desde la versión 2.2.0. No lleva Authorization. Los detalles están en Autenticación y KYC.

Ir directo a lo que necesitás

Si tenés que…	Página
Autenticar tus llamadas	Autenticación
Crear un enlace de verificación	Enlaces
Leer el resultado y los datos del documento	KYC
Entender la prueba de vida y el flujo adaptativo	Prueba de vida
Recibir eventos en tu servidor	Webhooks
Resolver un código HTTP inesperado	Errores
Leer un documento de identidad por API	ID Analysis
Comparar dos rostros	Face Analysis
Detectar una selfie falsificada	Antispoofing Facial
Identificar el dispositivo de una conexión	Connection Fingerprint
Ver qué cambió en la API	Changelog

URLs base

Servicio	URL base	Autenticación
VU Identity Link API	`https://api.identity.vu-one.com/api/v1`	`Authorization: Bearer`
ID Analysis	Provista por VU según el ambiente	`Api-Key`
Face Analysis	Provista por VU según el ambiente	`Api-Key`
Antispoofing Facial	Provista por VU según el ambiente	`Api-Key`
Connection Fingerprint	`https://fingerprint.api.vusecurity.com`	Ninguna en el endpoint principal

Las api-keys y los clientSecret viven en tu backend, en un gestor de secretos. Nunca dentro de una app móvil ni de un bundle de frontend: cualquiera puede extraerlos del binario.

Recursos

Changelog

Versiones, cambios de comportamiento y recomendaciones de migración.

Wiki

Documentación interna adicional para equipos de VU.

Soporte

Escribí con el id de la transacción, el ambiente y la marca de tiempo.

VU Security es la plataforma de identidad digital de América Latina. La información no técnica —soluciones por caso de uso, industrias, certificaciones y sobre VU— vive en vusecurity.com.

VU Identity Link

VU Cloud Services

​Qué podés hacer con Identity Link

1. Verificá a cualquiera en tres pasos

2. Los documentos de tu cliente no viajan por WhatsApp

3. Pasá a Premium e integrá por API

4. Pasá a Pro y ajustalo a tus reglas

5. El cliente que vuelve se verifica con una selfie

​Empezar en cinco minutos

​Ir directo a lo que necesitás

​URLs base

​Recursos

Changelog

Wiki

Soporte

Qué podés hacer con Identity Link

Empezar en cinco minutos

Ir directo a lo que necesitás

URLs base

Recursos