> ## 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.
# Início rápido: sua primeira verificação de identidade
> Quem é a VU, para que serve o Identity Link e dois caminhos para rodar sua primeira verificação de identidade: pelo aplicativo, sem escrever código, ou pela API.
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
Cadastre-se em [identity.vu-one.com/signup](https://identity.vu-one.com/signup). Contas novas começam no **Basic**: 10 verificações por mês, sem cartão de crédito.
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.
Abra **Verificações** e clique em **Criar link**. Escolha o fluxo completo — documento mais prova de vida — e copie a URL retornada. Ela é assim:
```text theme={null}
https://identity.vu-one.com/validationprocess?link=550e8400-e29b-41d4-a716-446655440000
```
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.
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](/pt/identity-link/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"*.
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](https://www.vusecurity.com/contacto).
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.
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`.
```bash Requisição 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 Resposta theme={null}
{
"access_token": "eyJhbGciOiJSUzI1NiIs...",
"expires_in": 3600,
"token_type": "Bearer"
}
```
`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](/pt/identity-link/introducao#fluxo-adaptativo) usa depois para reconhecer um cliente que volta.
```bash Requisição 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://seusite.com/retorno",
"metadata": {"campanha": "quickstart"}
}'
```
```json Resposta 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"
}
```
Envie a `linkUrl` para a pessoa exatamente como no Caminho A.
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:
```json theme={null}
{
"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](/pt/identity-link/webhooks). Ou consulte o endpoint público de status, que dispensa token:
```bash theme={null}
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](/pt/identity-link/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
O que cada plano muda: cota, janelas de expiração, marca, precisão da localização e hospedagem.
Ciclo de vida do token, rotação de credenciais e onde os segredos devem ficar.
Cada campo de um link, o fluxo adaptativo e o ciclo completo, da criação à expiração.
Os doze eventos, o formato do payload e como validar a assinatura.
## Related topics
- [VU Cloud Services](/pt/vucs/introducao.md)
- [Documentação técnica da VU](/pt/index.md)
- [Ler Resultados KYC de Verificações de Identidade](/pt/identity-link/kyc.md)
- [Criar e Gerenciar Links de Verificação](/pt/identity-link/links.md)
- [Webhooks do Identity Link: Eventos do Ciclo de Verificação](/pt/identity-link/webhooks.md)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.