> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/produtos/editor-1.md).

# Facephi Onboarding

### **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**

* SDK Frontend (Web ou Mobile): captura de rosto e documento
* [Documentação Mobile SDK](/docs.facephi-pt-br/sdks/sdk-mobile.md)
* [Documentação Web SDK](/docs.facephi-pt-br/sdks/sdk-web.md)

**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`
* [Documentação API Rest](/docs.facephi-pt-br/api-rest/identity-api.md)

**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.