Integração
O que este caso de uso resolve
A verificação de identidade com captura e reutilização de documento resolve o desafio de verificar a identidade com o conjunto mais amplo de sinais de risco, incluindo também a captura de um documento governamental, tudo em um único processo.
Use este caso de uso quando:
- Você precisa de verificação biométrica de identidade combinada com alertas comportamentais e captura de documento.
Não use este caso de uso quando:
- Você não precisa de captura de documento → consulte os outros casos de uso de onboarding.
Capacidades envolvidas
Pipeline executado dentro de um único processo:
| Capacidade | Obrigatória | Função no fluxo |
|---|---|---|
| Liveness | Opcional para API; obrigatória para Web e Native | Confirma que uma pessoa real está à frente da câmera no momento da captura. Âncora biométrica do processo. |
| Identity Verification | Obrigatória em todos os casos | Verifica se o rosto da transação pertence ao titular do identificador governamental fornecido, usando a base de identidade da Unico e sinais adicionais. |
| Risk Fraud Classification | Obrigatória em todos os casos | Cruza sinais comportamentais para sinalizar risco de fraude associado ao identificador do documento. |
| Document Capture & Reuse | Obrigatória em todos os casos | Captura uma nova imagem de documento ou retorna uma imagem capturada anteriormente associada ao usuário. |
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
- Native
- 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.
Operando no México?O KYC Magic Link oferece uma alternativa com zero desenvolvimento front-end — envie um link via WhatsApp, SMS ou e-mail e a Unico hospeda toda a jornada de captura INE + liveness para você. Sem necessidade de instalação de SDK.
