Verificação de Idade
O que este caso de uso resolve
Permite comprovar que o usuário atende à idade mínima exigida de forma 100% biométrica, sem atrito com documentos. Indicado para fluxos em que a estimativa de idade facial já é suficiente para a decisão — como acesso a conteúdo adulto, apostas esportivas ou bebidas alcoólicas em ambientes digitais.
Use este caso de uso quando:
- A regulação ou política interna não exige comprovação documental de idade.
- A prioridade é minimizar o atrito na jornada do usuário.
- O contexto de uso aceita a estimativa biométrica como prova suficiente (ex.: plataformas de streaming, apostas, conteúdo adulto).
- O volume de transações é alto e a captura de documentos representaria um gargalo operacional.
Não use este caso de uso quando:
- A regulação exige comprovação documental de idade.
- O serviço envolve alto risco regulatório ou financeiro (ex.: crédito, saúde).
- A faixa etária do público-alvo torna a estimativa facial menos confiável (por exemplo, adolescentes próximos à idade legal).
Capacidades envolvidas
Pipeline executado dentro de um único processo:
| Capacidade | Obrigatória | Papel no fluxo |
|---|---|---|
| Liveness | Opcional para API; obrigatória para Web e Nativo | Confirma que uma pessoa real está diante da câmera no momento da captura. Âncora biométrica do processo. |
| Verificação de Identidade | Obrigatório para idage; não utilizado em idagedocumentless | Verifica se o rosto da transação pertence ao titular do identificador governamental fornecido, usando a base de identidade da Unico e sinais adicionais. |
| Verificação de Idade | Obrigatória | Estima a faixa etária a partir da biometria facial. O resultado determina se o usuário atinge a idade mínima exigida. |
Pré-requisitos
- Bearer token — consulte Autenticação.
- Credenciais de Sandbox — consulte Ambientes.
- SDK ou componente Web instalado — somente para integrações Web e SDK. Consulte SDKs e Ferramentas.
Implementação passo a passo
- Nativo
- Web
- API
Integração via SDK nativo — a captura é executada dentro do seu app usando o SDK da Unico para Android, iOS ou Flutter.
- Instale o SDK — adicione a dependência do SDK da Unico para a sua plataforma. Consulte o guia de configuração para Android, iOS ou Flutter.
- Crie um processo — chame Create Process com o valor de
flowapropriado e o identificador do usuário. Use otokenretornado para inicializar o SDK. - Inicie a captura — o SDK exibe a interface da câmera e realiza a detecção de vivacidade no dispositivo, retornando o payload capturado.
- Consulte o resultado — chame Get Process para recuperar os resultados das capabilities.
- Aplique as regras de negócio — avalie os campos da resposta para aprovar, reprovar ou escalar.
Integração via iFrame, Redirect ou Nativa — a Unico hospeda a interface de captura e você recebe o resultado via polling.
- Crie um processo — chame Create Process com o valor de
flowapropriado e o identificador do usuário. A resposta inclui umauserRedirectUrl. - Redirecione o usuário — envie o usuário para
userRedirectUrl. A Unico renderiza a jornada de captura. Ou utilizewebAppTokenem apps nativos. - O usuário completa a jornada — após a captura, o usuário é redirecionado de volta para o seu
callbackUri. - Consulte o resultado — chame Get Process para recuperar os resultados das capabilities.
- Aplique as regras de negócio — avalie os campos da resposta para aprovar, reprovar ou escalar.
Integração direta via API — capture o selfie usando o SDK da Unico ou sua própria UI seguindo o Padrão de Captura, e então envie a imagem diretamente para a API da Unico.
- Capture o selfie — use o SDK da Unico para sua plataforma, ou construa sua própria UI seguindo o Padrão de Captura, para obter uma imagem de selfie que atenda aos requisitos de liveness.
- Crie um processo — chame Criar Processo com o identificador do usuário e o selfie como
imagebase64. - Consulte o resultado — chame Obter Processo para recuperar os resultados das capabilities.
- Aplique as regras de negócio — avalie os campos da resposta para aprovar, reprovar ou escalar.
Próximos passos
- Teste primeiro no Sandbox — use credenciais de sandbox para validar o fluxo completo antes de ir para produção. Consulte Ambientes.
- Configure webhooks — receba notificações de resultado de forma assíncrona em vez de polling. Consulte Webhooks e Eventos.
Casos de uso relacionados
- Onboarding — Fluxo completo de onboarding com verificação de documento e identidade biométrica.


