Visão geral

O ID One é um produto desenvolvido a partir de uma parceria com a Unico, um dos maiores bureaus de faces do Brasil. Trata-se de um fluxo de análise das imagens utilizadas no processo de Onboarding de pessoa física.

Por apresentar maior precisão no exame das imagens, o ID One auxilia no aumento da taxa de aprovação de clientes, diminui o índice de casos encaminhados para o serviço de derivação de mesa e garante assertividade na identificação de tentativas de Onboardings fraudulentos.

Sua análise contará com os seguintes benefícios:

• Prova de vida: o ID One solicita ao usuário que aproxime e distancie o rosto da câmera durante o momento da captura da selfie e analisa suas características faciais. Caso haja algum ajuste a ser feito (como posição do rosto, por exemplo), ele será sinalizado ao cliente. Por essa interatividade com o usuário, é possível detectar se o indivíduo que está tentando o cadastro é de fato uma pessoa, e não a foto de uma foto, uma foto de celular etc.;
• OCR: os dados do usuário são extraídos das fotos dos documentos;
• Tipificação de documentos: o documento é tipificado como RG, CNH, RNE, DNI ou CRNM e é verificado se ele corresponde ao que foi solicitado para análise;
• Facematch: a foto presente no documento é comparada com a selfie do usuário;
• Autenticação 1:N: o rosto do usuário é comparado com toda a base de dados da Unico;
• Score biométrico: o resultado da análise do rosto é retornado em formato de score biométrico, que possui 99,95% de precisão.

Fluxo

A partir da integração com o ID One, é possível iniciar o fluxo de análise de imagens. O fluxo é composto pelas seguintes etapas:

Criação do processo de selfie

O parceiro deve chamar o endpoint de criação do processo de selfie, que retorna uma userRedirectUrl — a URL da webview da Unico para onde o cliente deverá ser redirecionado para realizar a captura.

⚠️

Importante

A selfie deve ser enviada antes das outras imagens e é preciso aguardar que ela seja aprovada antes de iniciar a captura das imagens dos documentos.

❗️

Atenção

A userRedirectUrl possui prazo de expiração. Caso o cliente não realize a captura dentro desse período, será necessário criar um novo processo de selfie. Consulte o campo expiresAt retornado no response para verificar o prazo.

Captura das imagens do documento

Após a aprovação da selfie, o parceiro deve capturar as imagens do documento de identificação (frente e verso) a partir da máscara utilizada pelo parceiro. Os documentos permitidos para envio são RG e CNH.

• Todas as imagens deverão apresentar o documento fechado;
• As fotos deverão ser capturadas a partir da máscara do parceiro.

❗️

Atenção

Para aumentar as chances de aprovação no Onboarding, é preciso seguir todas as recomendações contidas na página Orientações para envio de fotos.

Envio das imagens do documento

Após a captura, o parceiro deve enviar as imagens ao Hiperbanco por meio do endpoint de envio de documentos pessoais com ID One, nos formatos .jpeg, .jpg ou .png.

Análise das imagens

Ao receber as imagens, iniciam-se as análises de:

• Prova de vida;
• OCR;
• Tipificação de documentos;
• Facematch;
• Autenticação 1:N;
• Score biométrico.

📘

Nota

A prova de vida é realizada no momento da captura da selfie na webview da Unico.

Resultado da análise

O resultado da análise é enviado ao parceiro via webhook, utilizando os mesmos eventos publicados no processo de Onboarding atual. Não será possível obter dados pelo endpoint de consulta de eventos.

Status de aprovação

Veja a seguir os status para que as imagens sejam consideradas aprovadas:

• Selfie: os status das análises de liveness e face details devem ser LIVENESS_FOUND e DETECTED_FACE, respectivamente;
• Frente do documento: os status das análises de face match e OCR devem ser HAS_FACE_MATCH e DETECTED_DOCUMENT, respectivamente;
• Verso do documento: o status da análise OCR deve ser DETECTED_DOCUMENT.

📘

Nota

Esses status chegam no webhook DOCUMENT_WAS_PROCESSED.

Configuração visual da webview

Ao criar o processo de selfie, o endpoint retorna uma userRedirectUrl — a URL da webview da Unico para onde o cliente será redirecionado para realizar a captura.

Para que essa webview seja exibida com a identidade visual do parceiro, é obrigatório fornecer ao Hiperbanco as seguintes informações antes da ativação do ambiente de produção:

⚠️

Importante

O envio dessas informações é obrigatório para a liberação do ambiente de produção. O parceiro deve encaminhá-las à equipe de integração do Hiperbanco antes de solicitar a ativação.

⚠️

Importante

O tempo máximo de resposta de nossas APIs é de 30 segundos.