> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vu-one.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Inicio rápido: tu primera verificación de identidad
> Quién es VU, para qué sirve Identity Link y dos formas de correr tu primera verificación de identidad: desde la aplicación sin escribir código, o por API.
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
Registrate en [identity.vu-one.com/signup](https://identity.vu-one.com/signup). Las cuentas nuevas arrancan en **Basic**: 10 verificaciones por mes, sin tarjeta de crédito.
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.
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í:
```text theme={null}
https://identity.vu-one.com/validationprocess?link=550e8400-e29b-41d4-a716-446655440000
```
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ó.
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](/identity-link/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"*.
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](https://www.vusecurity.com/contacto).
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.
Cambiá el par de credenciales por un token Bearer válido 3600 segundos. Las credenciales viajan codificadas en Base64 en el header `Authorization: Basic`.
```bash Request theme={null}
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"
```
```json Response theme={null}
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"expires_in": 3600,
"token_type": "Bearer"
}
```
`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](/identity-link/introduccion#flujo-adaptativo) más adelante para reconocer a un cliente que vuelve.
```bash Request theme={null}
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"}
}'
```
```json Response theme={null}
{
"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.
Hay dos maneras, y no se excluyen. Registrá un endpoint con `POST /webhook-endpoints` y VU publica cada paso a medida que ocurre:
```json theme={null}
{
"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](/identity-link/webhooks). O consultá el endpoint público de estado, que no necesita token:
```bash theme={null}
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](/identity-link/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
Qué cambia cada plan: cupo, ventanas de expiración, marca, precisión de ubicación y despliegue.
Ciclo de vida del token, rotación de credenciales y dónde van los secretos.
Cada campo de un enlace, el flujo adaptativo y el ciclo completo desde la creación hasta la expiración.
Los doce eventos, la forma del payload y cómo validar la firma.
## Related topics
- [Documentación técnica de VU](/index.md)
- [Leer resultados KYC de verificaciones de identidad](/identity-link/kyc.md)
- [Webhooks de Identity Link: eventos del ciclo de verificación](/identity-link/webhooks.md)
- [Planes de Identity Link](/identity-link/planes.md)
- [Crear y gestionar enlaces de verificación](/identity-link/enlaces.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.