Início rápido: sua primeira verificação de identidade

A VU é uma empresa latino-americana de identidade digital e prevenção à fraude. Há quase duas décadas ela constrói a camada de identidade de bancos, operadoras, varejistas e órgãos públicos da região — hoje protegendo mais de 350 milhões de usuários em 170 organizações. O VU Identity Link é a porta de entrada autosserviço para essa plataforma. Captura documental, OCR, prova de vida certificada e antispoofing — o mesmo motor que a VU entrega em projetos corporativos — empacotados em algo que você começa a usar sozinho, hoje mesmo: você cria um link de uso único, envia para uma pessoa, ela se verifica no navegador que já tem, e o resultado volta para você. Sem projeto de integração, sem contato comercial, sem nada para o seu cliente instalar.

São dois caminhos de entrada, e você não precisa escolher um para sempre. O Caminho A roda inteiramente no aplicativo e funciona no plano Basic, que é gratuito. O Caminho B é a API, e exige Premium ou Pro. A maioria dos times começa pelo A para ver uma verificação real e depois migra para o B.

Caminho A — Verificar alguém hoje, sem escrever código

Crie sua conta

Cadastre-se em identity.vu-one.com/signup. Contas novas começam no Basic: 10 verificações por mês, sem cartão de crédito.

Deixe com a sua cara

Vá em Configurações → Seu negócio e defina o nome comercial que o seu cliente verá nas telas de verificação. No Basic esse é o único controle de marca disponível; logo e cor são liberados no Premium.

Crie um link

Abra Verificações e clique em Criar link. Escolha o fluxo completo — documento mais prova de vida — e copie a URL retornada. Ela é assim:

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

Compartilhe

Envie a URL pelo canal que você já usa com essa pessoa: e-mail, WhatsApp, SMS ou QR code. Ela abre o link no navegador, fotografa a frente e o verso do documento e conclui a prova de vida.Você compartilha um link, não os documentos do seu cliente. As capturas trafegam dentro da sessão do próprio link, direto para a VU. No Basic o link para de funcionar 30 minutos depois de criado, e em qualquer plano ele é de uso único: assim que alguém o conclui, está gasto.

Leia o resultado

A verificação sai da aba Ativos e vai para Verificados. Abra o cartão dela e clique em Dados do cliente para ver os campos lidos do documento.No Basic esses dados ficam legíveis por 60 minutos a partir da criação: os 30 minutos da janela do link mais os 30 da janela de dados, que se somam. Depois disso o cartão continua listado como registro de que a verificação aconteceu, mas os dados não estão mais lá.

O que o Basic não inclui: acesso à API, logo e cor, janelas de expiração maiores que 30 minutos e localização precisa do cliente. Em Planos está exatamente o que cada nível muda.

Caminho B — Integrar ao seu produto

A API exige Premium ou Pro. No Basic, POST /oauth/token responde 401 invalid_client com a mensagem “User must have Premium or Pro plan”.

Faça o upgrade

Abra Planos no aplicativo e assine o Premium: USD 49,99 por mês, 100 verificações mensais. Se você precisa de uma cota sob medida, janelas mais longas ou hospedagem fora do SaaS compartilhado, fale com a gente sobre o Pro.

Pegue suas credenciais

Vá em Configurações → Desenvolvedores. Lá estão o seu Client Id, o Client Secret e o Webhook Secret, além da Callback Url padrão usada quando uma verificação termina. Atualizar rotaciona uma credencial quando for preciso.Os mesmos valores voltam em GET /users/me numa chamada autenticada. Nos dois casos, eles moram no seu backend e num gerenciador de segredos — nunca num app móvel nem num bundle de frontend.

Peça um token

Troque o par de credenciais por um token Bearer válido por 3600 segundos. As credenciais trafegam codificadas em Base64 no cabeçalho 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"
}

Crie um link

FULL FLOW é documento mais prova de vida; ID ONLY lê o documento e para por aí. externalUserId é o seu próprio identificador daquela pessoa — e é também o que o fluxo adaptativo usa depois para reconhecer um cliente que volta.

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://seusite.com/retorno",
    "metadata": {"campanha": "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"
}

Envie a linkUrl para a pessoa exatamente como no Caminho A.

Receba o resultado

Há dois jeitos, e eles não se excluem. Registre um endpoint com POST /webhook-endpoints e a VU publica cada etapa conforme ela acontece:

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

Valide o cabeçalho X-Signature-SHA256 contra o seu webhookSecret antes de confiar no evento — o detalhe está em Webhooks. Ou consulte o endpoint público de status, que dispensa token:

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

Nos dois casos, os campos do documento vêm de um GET /verifications/{id} autenticado. Em KYC está cada campo retornado.

Leia o resultado enquanto a janela estiver aberta. Passado o expiresAt da verificação, GET /verifications/{id} responde 410 e as imagens respondem 404, seja qual for o seu plano — a janela é a soma dos seus tempos de expiração de link e de dados.

Próximos passos

Planos

O que cada plano muda: cota, janelas de expiração, marca, precisão da localização e hospedagem.

Autenticação

Ciclo de vida do token, rotação de credenciais e onde os segredos devem ficar.

Links

Cada campo de um link, o fluxo adaptativo e o ciclo completo, da criação à expiração.

Webhooks

Os doze eventos, o formato do payload e como validar a assinatura.

​Caminho A — Verificar alguém hoje, sem escrever código

​Caminho B — Integrar ao seu produto

​Próximos passos

Planos

Autenticação

Links

Webhooks

Caminho A — Verificar alguém hoje, sem escrever código

Caminho B — Integrar ao seu produto

Próximos passos