> ## 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.

# Documentación técnica de VU

> Documentación de integración de VU Security: VU Identity Link para verificación de identidad de punta a punta y VU Cloud Services: ID Analysis, Face Analysis, Antispoofing Facial y Connection Fingerprint.

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.

<Warning>
  **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](/identity-link/planes) para ver qué incluye cada uno.
</Warning>

<CardGroup cols={2}>
  <Card title="VU Identity Link" icon="link" horizontal href="/identity-link/introduccion">
    **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`
  </Card>

  <Card title="VU Cloud Services" icon="cloud" horizontal href="/vucs/introduccion">
    **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**
  </Card>
</CardGroup>

## Qué podés hacer con Identity Link

<CardGroup cols={2}>
  <Card title="1. Verificá a cualquiera en tres pasos" icon="wand-magic-sparkles" href="/identity-link/enlaces">
    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.
  </Card>

  <Card title="2. Los documentos de tu cliente no viajan por WhatsApp" icon="shield-halved" href="/identity-link/planes#cuando-la-ventana-se-cierra">
    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.
  </Card>

  <Card title="3. Pasá a Premium e integrá por API" icon="code" href="/identity-link/autenticacion">
    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.
  </Card>

  <Card title="4. Pasá a Pro y ajustalo a tus reglas" icon="sliders" href="/identity-link/planes#cambiar-de-plan">
    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.
  </Card>

  <Card title="5. El cliente que vuelve se verifica con una selfie" icon="user-check" href="/identity-link/prueba-de-vida">
    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.
  </Card>
</CardGroup>

## Empezar en cinco minutos

<CodeGroup>
  ```bash 1. Obtener un token 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"
  ```

  ```bash 2. Crear un enlace theme={null}
  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"}'
  ```

  ```bash 3. Consultar el resultado theme={null}
  curl "https://api.identity.vu-one.com/api/v1/verifications/$VERIFICATION_ID/status?linkId=$LINK_ID"
  ```
</CodeGroup>

<Note>
  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](/identity-link/autenticacion) y [KYC](/identity-link/kyc).
</Note>

## Ir directo a lo que necesitás

| Si tenés que… | Página |
| - | - |
| Autenticar tus llamadas | [Autenticación](/identity-link/autenticacion) |
| Crear un enlace de verificación | [Enlaces](/identity-link/enlaces) |
| Leer el resultado y los datos del documento | [KYC](/identity-link/kyc) |
| Entender la prueba de vida y el flujo adaptativo | [Prueba de vida](/identity-link/prueba-de-vida) |
| Recibir eventos en tu servidor | [Webhooks](/identity-link/webhooks) |
| Resolver un código HTTP inesperado | [Errores](/identity-link/errores) |
| Leer un documento de identidad por API | [ID Analysis](/vucs/id-analysis/introduccion) |
| Comparar dos rostros | [Face Analysis](/vucs/face-analysis/introduccion) |
| Detectar una selfie falsificada | [Antispoofing Facial](/vucs/antispoofing-facial/introduccion) |
| Identificar el dispositivo de una conexión | [Connection Fingerprint](/vucs/connection-fingerprint/introduccion) |
| Ver qué cambió en la API | [Changelog](/identity-link/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 |

<Warning>
  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.
</Warning>

## Recursos

<CardGroup cols={3}>
  <Card title="Changelog" icon="clock-rotate-left" href="/identity-link/changelog">
    Versiones, cambios de comportamiento y recomendaciones de migración.
  </Card>

  <Card title="Wiki" icon="arrow-up-right-from-square" href="https://wiki.corp.vusecurity.com/es/home">
    Documentación interna adicional para equipos de VU.
  </Card>

  <Card title="Soporte" icon="life-ring" href="mailto:customer.support@vusecurity.com">
    Escribí con el `id` de la transacción, el ambiente y la marca de tiempo.
  </Card>
</CardGroup>

***

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](https://vusecurity.com).


## Related topics

- [Changelog de Identity Link API](/identity-link/changelog.md)
- [Códigos de error y respuestas de la Identity Link API](/identity-link/errores.md)
- [Guía de integración](/vucs/face-analysis/integracion.md)
- [Interpretación de respuestas](/vucs/face-analysis/respuestas.md)
- [VU Cloud Services](/vucs/introduccion.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.