For the complete documentation index, see llms.txt. This page is also available as Markdown.

Facephi Onboarding

O processo de onboarding digital permite registrar novos usuários de forma remota e segura, verificando sua identidade por meio de documentos oficiais e biometria facial.

O que este produto resolve?

Permite registrar novos usuários de forma remota, segura e sem atritos. O processo combina captura documental, biometria facial e validações em tempo real.

Integração Saas

SDKs necessários

Serviços de back-end necessários (API REST)

  • Validação de teste de vida e comparação facial: POST /v2/identity

  • Extração OCR de documento:

    • Mobile: POST /extractDocumentData

    • Web: POST /extractDocumentDataWeb

  • Validação de documento:

    • Por morfologia: POST /documentValidation/v2

    • Contra registro civil: POST /civilValidation

Outros serviços

  • Validação de Onboarding duplicado (opcional): POST /blacklist

Fluxo técnico sugerido

1. Componente SelphID (escaneamento de documento)

  • Realizar a captura do documento por meio do Widget SelphID (Web ou Mobile).

2. Componente Selphi (captura do rosto)

  • Realizar a Captura Facial por meio do Widget Selphi (Web ou Mobile).

  • Consumir os seguintes endpoints nesta ordem:

    • /documentValidation/v2 Enviar a imagem completa com contexto para validar a morfologia do documento.

    • /extractDocumentDataWeb ou /extractDocumentData Obter os dados OCR extraídos do documento para seu processamento.

    • /v2/identity

      Realiza o teste de vida e a comparação da selfie com a imagem do documento em uma única chamada.

Requisitos e licenças

Frontend

  • Web: URL / porta

  • Mobile: package name ou bundle ID

Backend

  • api-key para o consumo da API

Recomendações técnicas

Persistência de Template Biométrico

É requisito obrigatório que o cliente persista o Template Biométrico (templateRaw) gerado por meio do Widget Selphi durante o fluxo de Onboarding ou de cadastramento.

Este Template Biométrico é um elemento essencial, pois será utilizado posteriormente nos fluxos de autenticação biométrica facial. Sua correta conservação garante a continuidade e a efetividade do processo de Verificação de Identidade em futuras sessões.

Recomenda-se armazenar essas informações de forma segura e criptografada, em conformidade com as normas de proteção de dados pessoais e políticas internas do cliente.

FAQs

  • Qual é a diferença entre validação morfológica e por Registro Civil?

A validação morfológica é utilizada naqueles países onde não existem bases de dados governamentais biométricas e/ou de dados disponíveis para a Verificação de Identidade. Seu objetivo principal é determinar a autenticidade dos documentos apresentados, por meio da análise de suas características físicas e visuais. Adicionalmente, esse tipo de validação é empregado para a comprovação de documentos de identificação, como passaportes e carteiras de motorista.

  • É obrigatório usar ambas as validações de documento?

Não é obrigatório utilizar ambas as validações de documento. No entanto, recomenda-se que pelo menos uma das duas validações esteja habilitada, a fim de assegurar a veracidade e a autenticidade do documento apresentado. Não obstante, poderão existir requisitos de negócio, regulatórios ou de risco que determinem a necessidade de utilizar ambas as validações de forma conjunta. Por exemplo, quando não são aceitas apresentações de tela ou cópias digitais do documento, torna-se obrigatória a utilização da validação morfológica para garantir a autenticidade do documento físico.


Glossário e conceitos-chave

  • teste de vida passivo: O teste de vida (Liveness) em Facephi é um mecanismo de segurança biométrica que permite verificar se a pessoa que interage com o sistema é um ser humano real, está fisicamente presente e não se trata de uma imagem, vídeo, máscara ou conteúdo sintético.

    Seu objetivo principal é prevenir ataques de falsificação de identidade, como o uso de fotografias impressas, vídeos pré-gravados ou tentativas de fraude mais sofisticadas, incluindo deepfakes, durante os processos de verificação e autenticação biométrica.

  • Matching facial: No fluxo de Onboarding, o Matching facial consiste na comparação da imagem selfie capturada em tempo real com a imagem do rosto contida na frente do Documento de identidade apresentado pelo usuário, com o objetivo de verificar se ambas as imagens correspondem à mesma pessoa.

    Esse processo permite confirmar que o usuário que realiza o Onboarding é o titular legítimo do documento, reforçando a Verificação de Identidade e reduzindo o risco de falsificação de identidade.

Atualizado