Documentação técnica da VU

Referência de integração dos produtos de identidade da VU. Tudo o que segue foi escrito para quem vai escrever o código: endpoints, contratos, códigos de erro e as armadilhas que só aparecem em produção.

A API do VU Identity Link está disponível apenas nos planos Premium e Pro. O plano Basic não tem acesso por API: POST /oauth/token responde 401 invalid_client. Veja Planos para saber o que cada plano inclui.

VU Identity Link

Verificação de identidade ponta a ponta. Links de uso único, captura documental, OCR, prova de vida e fluxo adaptativo. Uma integração resolve o processo inteiro.OAuth2 · REST · Webhooks

VU Cloud Services

APIs que você integra uma a uma. O ID Analysis lê o documento, o Face Analysis compara os rostos, o Antispoofing Facial confirma que a selfie é de uma pessoa real e o Connection Fingerprint identifica o dispositivo.Api-Key · REST · Sem SDK · Disponível

O que você pode fazer com o Identity Link

1. Verifique qualquer pessoa em três passos

Você cria um link, compartilha e lê o resultado. POST /links devolve um linkUrl que você envia pelo canal que já usa com seu cliente: e-mail, WhatsApp, SMS ou um QR code. Sem app para instalar nem SDK para publicar: roda no navegador que a pessoa já tem.

2. Os documentos do seu cliente não viajam pelo WhatsApp

Você compartilha um link, não a foto de um documento. O documento e a selfie vão direto para a VU dentro da sessão do próprio link, que é de uso único e fecha num relógio definido por você. Passada essa janela a API responde 410 para o registro e 404 para as imagens, não importa o que o app de mensagens ainda guarde.

3. Vá para o Premium e integre por API

OAuth2 client credentials, uma API REST e webhooks assinados com HMAC-SHA256 para que seu servidor possa confiar no que recebe. O Premium sobe a cota para 100 verificações por mês e libera a personalização completa: seu nome, seu logo e sua cor em cada tela que seu cliente vê.

4. Vá para o Pro e ajuste às suas regras

O suporte configura sua cota de verificações e as duas janelas de expiração nos valores exatos de que você precisa, em minutos e não em opções fixas. O Pro também é o único plano que pode rodar fora do SaaS compartilhado.

5. O cliente que volta se verifica com uma selfie

O fluxo adaptativo leva o cliente que já se verificou para uma ramificação só de rosto e pula por completo a captura documental. O endpoint de status informa qual ramificação rodou em method: FACE ou DOCUMENT. Disponível a partir da versão 2.2.0.

Começar em 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"

O endpoint de status é público e exige o parâmetro linkId desde a versão 2.2.0. Ele não leva Authorization. Os detalhes estão em Autenticação e KYC.

Ir direto ao que você precisa

Se você precisa…	Página
Autenticar suas chamadas	Autenticação
Criar um link de verificação	Links
Ler o resultado e os dados do documento	KYC
Entender a prova de vida e o fluxo adaptativo	Prova de vida
Receber eventos no seu servidor	Webhooks
Resolver um código HTTP inesperado	Erros
Ler um documento de identidade por API	ID Analysis
Comparar dois rostos	Face Analysis
Detectar uma selfie falsificada	Antispoofing Facial
Identificar o dispositivo de uma conexão	Connection Fingerprint
Ver o que mudou na API	Changelog

URLs base

Serviço	URL base	Autenticação
VU Identity Link API	`https://api.identity.vu-one.com/api/v1`	`Authorization: Bearer`
ID Analysis	Fornecida pela VU por ambiente	`Api-Key`
Face Analysis	Fornecida pela VU por ambiente	`Api-Key`
Antispoofing Facial	Fornecida pela VU por ambiente	`Api-Key`
Connection Fingerprint	`https://fingerprint.api.vusecurity.com`	Nenhuma no endpoint principal

As api-keys e os clientSecret vivem no seu backend, em um gerenciador de segredos. Nunca dentro de um app móvel nem de um bundle de frontend: qualquer pessoa consegue extraí-los do binário.

Recursos

Changelog

Versões, mudanças de comportamento e recomendações de migração.

Wiki

Documentação interna adicional para as equipes da VU.

Suporte

Escreva com o id da transação, o ambiente e o carimbo de tempo.

A VU Security é a plataforma de identidade digital da América Latina. O material não técnico — soluções por caso de uso, indústrias, certificações e sobre a VU — fica em vusecurity.com.

VU Identity Link

VU Cloud Services

​O que você pode fazer com o Identity Link

1. Verifique qualquer pessoa em três passos

2. Os documentos do seu cliente não viajam pelo WhatsApp

3. Vá para o Premium e integre por API

4. Vá para o Pro e ajuste às suas regras

5. O cliente que volta se verifica com uma selfie

​Começar em cinco minutos

​Ir direto ao que você precisa

​URLs base

​Recursos

Changelog

Wiki

Suporte

O que você pode fazer com o Identity Link

Começar em cinco minutos

Ir direto ao que você precisa

URLs base

Recursos