Inicio rápido: tu primera verificación de identidad

VU es una empresa latinoamericana de identidad digital y prevención del fraude. Desde hace casi dos décadas construye la capa de identidad de bancos, telcos, comercios y organismos públicos de la región: hoy protege a más de 350 millones de usuarios en 170 organizaciones. VU Identity Link es la puerta de entrada autogestionada a esa plataforma. Captura documental, OCR, prueba de vida certificada y antispoofing —el mismo motor que VU despliega en proyectos empresariales— empaquetados en algo que podés empezar a usar solo, esta misma tarde: creás un enlace de un solo uso, se lo mandás a una persona, esa persona se verifica en el navegador que ya tiene, y el resultado vuelve a vos. Sin proyecto de integración, sin llamada comercial, sin nada que tu cliente deba instalar.

Hay dos caminos de entrada, y no tenés que elegir uno para siempre. El Camino A funciona enteramente desde la aplicación y anda con el plan Basic, que es gratuito. El Camino B es la API, y requiere Premium o Pro. La mayoría de los equipos arranca por el A para ver una verificación real, y después pasa al B.

Camino A — Verificar a alguien hoy, sin escribir código

Creá tu cuenta

Registrate en identity.vu-one.com/signup. Las cuentas nuevas arrancan en Basic: 10 verificaciones por mes, sin tarjeta de crédito.

Hacela tuya

Entrá a Configuración → Tu negocio y poné el nombre comercial que tu cliente va a ver en las pantallas de verificación. En Basic ese es el único control de marca disponible; el logo y el color se habilitan con Premium.

Creá un enlace

Abrí Verificaciones y hacé clic en Crear enlace. Elegí el flujo completo —documento más prueba de vida— y copiá la URL que te devuelve. Se ve así:

https://identity.vu-one.com/validationprocess?link=550e8400-e29b-41d4-a716-446655440000

Compartilo

Mandá la URL por donde ya te comunicás con esa persona: correo, WhatsApp, SMS o un código QR. La persona lo abre en su navegador, fotografía el frente y el dorso de su documento, y completa la prueba de vida.Estás compartiendo un enlace, no los documentos de tu cliente. Las capturas viajan dentro de la sesión propia del enlace, directo a VU. En Basic el enlace deja de funcionar 30 minutos después de creado, y en cualquier plan es de un solo uso: apenas alguien lo completa, se gastó.

Leé el resultado

La verificación pasa de la pestaña Activos a Verificados. Abrí su tarjeta y hacé clic en Datos del cliente para ver los campos leídos del documento.En Basic esos datos quedan legibles durante 60 minutos desde la creación: los 30 minutos de la ventana del enlace más los 30 de la ventana de datos, que se suman. Después de eso la tarjeta sigue listada como constancia de que la verificación ocurrió, pero los datos ya no están.

Lo que Basic no incluye: acceso a la API, logo y color, ventanas de expiración mayores a 30 minutos, y ubicación precisa del cliente. En Planes está exactamente qué cambia cada nivel.

Camino B — Integrarlo a tu producto

La API requiere Premium o Pro. Con Basic, POST /oauth/token responde 401 invalid_client con el mensaje “User must have Premium or Pro plan”.

Subí de plan

Abrí Planes en la aplicación y suscribite a Premium: USD 49.99 por mes, 100 verificaciones mensuales. Si necesitás un cupo a medida, ventanas más largas o un despliegue fuera del SaaS compartido, hablemos de Pro.

Buscá tus credenciales

Entrá a Configuración → Desarrolladores. Ahí están tu Client Id, tu Client Secret y tu Webhook Secret, además de la Callback Url por defecto que se usa cuando termina una verificación. Refrescar rota una credencial cuando lo necesites.Los mismos valores vuelven en GET /users/me con una llamada autenticada. En cualquiera de los dos casos, viven en tu backend y en un gestor de secretos: nunca en una app móvil ni en un bundle de frontend.

Pedí un token

Cambiá el par de credenciales por un token Bearer válido 3600 segundos. Las credenciales viajan codificadas en Base64 en el header Authorization: Basic.

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"

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "expires_in": 3600,
  "token_type": "Bearer"
}

Creá un enlace

FULL FLOW es documento más prueba de vida; ID ONLY lee el documento y termina ahí. externalUserId es tu propio identificador de esa persona, y es también lo que usa el flujo adaptativo más adelante para reconocer a un cliente que vuelve.

curl -X POST https://api.identity.vu-one.com/api/v1/links \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "FULL FLOW",
    "externalUserId": "cliente-12345",
    "callbackUrl": "https://tu-app.com/verificacion-completa",
    "metadata": {"campaign": "quickstart"}
  }'

{
  "linkId": "550e8400-e29b-41d4-a716-446655440000",
  "linkUrl": "https://identity.vu-one.com/validationprocess?link=550e8400-e29b-41d4-a716-446655440000",
  "verificationId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
}

Mandale la linkUrl a la persona igual que en el Camino A.

Obtené el resultado

Hay dos maneras, y no se excluyen. Registrá un endpoint con POST /webhook-endpoints y VU publica cada paso a medida que ocurre:

{
  "type": "verification.successful",
  "data": {
    "_verificationId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "_externalUserId": "cliente-12345",
    "_metadata": { "campaign": "quickstart" }
  }
}

Validá el header X-Signature-SHA256 contra tu webhookSecret antes de confiar en el evento: está detallado en Webhooks. O consultá el endpoint público de estado, que no necesita token:

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

En los dos casos, los campos del documento se leen con un GET /verifications/{id} autenticado. En KYC está cada campo que devuelve.

Leé el resultado mientras la ventana esté abierta. Pasado el expiresAt de la verificación, GET /verifications/{id} responde 410 y sus imágenes responden 404, sea cual sea tu plan: la ventana es la suma de tus tiempos de expiración de enlace y de datos.

Siguientes pasos

Planes

Qué cambia cada plan: cupo, ventanas de expiración, marca, precisión de ubicación y despliegue.

Autenticación

Ciclo de vida del token, rotación de credenciales y dónde van los secretos.

Enlaces

Cada campo de un enlace, el flujo adaptativo y el ciclo completo desde la creación hasta la expiración.

Webhooks

Los doce eventos, la forma del payload y cómo validar la firma.

​Camino A — Verificar a alguien hoy, sin escribir código

​Camino B — Integrarlo a tu producto

​Siguientes pasos

Planes

Autenticación

Enlaces

Webhooks

Camino A — Verificar a alguien hoy, sin escribir código

Camino B — Integrarlo a tu producto

Siguientes pasos