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

# Identity Link API: guía de integración completa

> Aprende cómo integrar VU Identity Link para verificar identidades digitales mediante biometría y captura documental en minutos.

VU Identity Link es una API REST que te permite verificar identidades digitales de forma remota. Combina captura documental con prueba de vida facial para confirmar que una persona real coincide con el documento presentado. Esta guía te muestra el flujo completo de integración, desde la creación de un enlace hasta la recepción de resultados.

## Qué es Identity Link

Una verificación es un enlace. Lo creás, lo compartís y la persona lo abre en el navegador que ya tiene: nada que instalar de su lado, ningún SDK que publicar del tuyo. Dentro de esa sesión fotografía su documento de identidad y, en el tipo `FULL FLOW`, completa la prueba de vida. VU lee el documento con OCR, compara la cara en vivo contra la foto impresa en él, revisa ambas capturas contra intentos de spoofing y te devuelve un único resultado consolidado.

Lo que la persona nunca hace es mandarte la foto de su documento por una app de mensajería. Las capturas viajan dentro de la sesión del propio enlace, y el registro que producen vive exactamente lo que duran las dos ventanas de vencimiento configuradas en tu cuenta. Después de eso la API responde `410` para el registro y `404` para sus imágenes.

<Note>
  **La API es una función paga.** Solo Premium y Pro pueden obtener un token: en Basic, `POST /oauth/token` responde `401 invalid_client`. El cupo de verificaciones, las ventanas de vencimiento, la personalización y la precisión de la ubicación cambian según el plan. Mirá [Planes](/identity-link/planes).
</Note>

## Flujo de integración

El proceso consta de cuatro etapas principales. Sigue la secuencia para entender cómo interactúan tu backend, la API de VU y el dispositivo del usuario final.

<Steps>
  <Step title="Autenticación">
    Tu backend obtiene un token Bearer mediante OAuth2 client credentials con tu `clientId` y `clientSecret`. El token tiene una duración de 3600 segundos.
  </Step>

  <Step title="Creación del enlace">
    Llamas a `POST /links` para generar un vínculo de un solo uso. Recibes `linkUrl`, `linkId` y `verificationId`.
  </Step>

  <Step title="Usuario completa la verificación">
    Compartes `linkUrl` con el usuario por email, WhatsApp, SMS o QR. El usuario captura el frente y reverso del documento, y en flujos FULL FLOW también realiza la prueba de vida facial.
  </Step>

  <Step title="Recepción de resultados">
    Recibes eventos de webhook en tiempo real o consultas el estado mediante polling. Finalmente lees los datos extraídos con `GET /verifications/{id}`.
  </Step>
</Steps>

## Arquitectura del flujo

```mermaid theme={null}
sequenceDiagram
    participant TU as Tu Backend
    participant API as Identity Link API
    participant USR as Dispositivo del Usuario
    TU->>API: POST /oauth/token
    API-->>TU: access_token (Bearer)
    TU->>API: POST /links
    API-->>TU: linkUrl, verificationId
    TU->>USR: Comparte linkUrl
    USR->>API: Abre link, captura documento + prueba de vida
    API-->>TU: Webhook: verification.successful
    TU->>API: GET /verifications/{id}
    API-->>TU: Datos extraídos (OCR + geolocalización)
```

## Tipos de flujo disponibles

VU Identity Link ofrece dos modalidades según tus necesidades de verificación:

<CardGroup cols={2}>
  <Card title="FULL FLOW" icon="id-card">
    Captura documental + prueba de vida facial anti-spoofing. Ideal para onboarding digital de alta seguridad.
  </Card>

  <Card title="ID ONLY" icon="file-lines">
    Solo captura y extracción de datos del documento. Útil para validaciones rápidas donde no se requiere biometría.
  </Card>
</CardGroup>

### Flujo adaptativo

Desde la versión 2.2.0, un Link `FULL FLOW` puede activar el **flujo adaptativo** con el campo `adaptiveFlow`. Cuando el cliente ya se verificó antes, el Link se resuelve en una rama de solo selfie y omite la captura documental. La rama efectiva se expone como `method` (`FACE` o `DOCUMENT`) en el endpoint de estado.

El flujo adaptativo necesita `externalUserId` para localizar la verificación previa. Si no lo conoces al crear el Link, el usuario puede aportar su email durante el flujo con `PATCH /verifications/identify`. Consulta [Enlaces de verificación](/identity-link/enlaces#flujo-adaptativo).

## URL base y versión

Todas las llamadas usan la siguiente URL base:

```text theme={null}
https://api.identity.vu-one.com/api/v1
```

La versión estable actual es **v2.3.2**. Los cambios de comportamiento se anuncian en el [changelog](/identity-link/changelog).

## Próximos pasos

Explora cada sección de la integración para implementar paso a paso:

<CardGroup cols={3}>
  <Card title="Autenticación" icon="key" href="/identity-link/autenticacion">
    Obtén tokens Bearer con OAuth2 client credentials.
  </Card>

  <Card title="Enlaces de verificación" icon="link" href="/identity-link/enlaces">
    Crea y gestiona enlaces de verificación de un solo uso.
  </Card>

  <Card title="KYC" icon="clipboard-check" href="/identity-link/kyc">
    Lee resultados, datos extraídos y estado de verificaciones.
  </Card>

  <Card title="Prueba de Vida" icon="face-viewfinder" href="/identity-link/prueba-de-vida">
    Entiende la biometría facial y anti-spoofing.
  </Card>

  <Card title="Webhooks" icon="bell" href="/identity-link/webhooks">
    Recibe notificaciones en tiempo real de cada evento.
  </Card>

  <Card title="Errores" icon="triangle-exclamation" href="/identity-link/errores">
    Maneja códigos de error y reintentos.
  </Card>
</CardGroup>

<Tip>
  Si necesitas información general sobre la plataforma VU Security, visita nuestra [wiki interna](https://wiki.corp.vusecurity.com/es/home).
</Tip>


## 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)
- [Planes de Identity Link](/identity-link/planes.md)
- [Webhooks de Identity Link: eventos del ciclo de verificación](/identity-link/webhooks.md)


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