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.

Sticker “code that protects” de VU: una terminal con el comando curl docs.vu-one.com/llms.txt y la dirección docs.vu-one.com

Conectá tu asistente de IA a esta documentación por MCP. Agregá el servidor vu-docs con la URL https://docs.vu-one.com/mcp. Tu asistente busca y lee estas páginas antes de responder, así el código que te propone usa los endpoints y contratos reales.

claude mcp add --transport http vu-docs https://docs.vu-one.com/mcp

{
  "mcpServers": {
    "vu-docs": {
      "url": "https://docs.vu-one.com/mcp"
    }
  }
}

La API de VU Identity Link está disponible en todos los planes, Basic incluido. En Basic, los enlaces que creás por API usan el mismo cupo que los del portal: 10 verificaciones por mes. Mirá Planes para ver qué incluye cada uno.

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. Integrá por API desde el plan Basic

OAuth2 client credentials, una API REST y webhooks firmados con HMAC-SHA256 para que tu servidor pueda confiar en lo que recibe. La API funciona en todos los planes. 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
Integrar Identity Link con tu asistente de IA	Con un asistente de IA
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
Crear un tenant de VU ONE FREE y hacer la primera llamada	Inicio rápido de VU ONE
Sumar el login de VU ONE a tu aplicación	Autenticación en VU ONE
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	`https://api.vu-one.com/id-analysis/prod`	`Api-Key`
Face Analysis	`https://api.vu-one.com/face-analysis/prod`	`Api-Key`
Antispoofing Facial	`https://api.vu-one.com/as-face/prod`	`Api-Key`
Connection Fingerprint	`https://fingerprint.api.vusecurity.com`	Ninguna en el endpoint principal
VU ONE	`https://<tenant>.prod.vu-one.com/middleware/api/v1`, una por tenant	`Authorization: Bearer`

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.