Pré-análise facial

Pré-requisitos de acesso

• Permissão (módulo): viewKycQueue (ver o resultado) e reviewKyc (decidir)
• Rota: dentro do detalhe (/kyc-queue/:userId)
• Licença/Feature: pré-análise facial habilitada para o tenant (faceMatch.enabled)

O que é / quando usar

A pré-análise facial compara automaticamente o rosto impresso no documento de identidade com o rosto da selfie enviada pelo investidor, e mostra o resultado no detalhe da fila. Serve para o Compliance Officer chegar na tela já sabendo onde olhar: os casos evidentes ficam evidentes, e os duvidosos ficam sinalizados.

A comparação roda dentro da própria plataforma, sem consulta a serviço externo e sem custo por análise. Nenhuma imagem sai do ambiente.

O veredito é apoio à decisão, não a decisão

A pré-análise nunca reprova ninguém sozinha. Um resultado "Divergente" sinaliza o caso para revisão — quem decide continua sendo o Compliance Officer, com step-up, como em qualquer outra decisão da fila.

Onde aparece

No detalhe do investidor, em um card próprio logo acima de Documentos do usuário — de propósito: você lê o veredito e, logo em seguida, tem as duas imagens lado a lado para conferir com os próprios olhos.

Como ler o resultado

O card mostra um veredito (colorido) e a distância que o gerou.

Veredito	Cor	O que significa	O que fazer
Confere	Verde	O rosto da selfie corresponde ao do documento com folga.	Caso fácil. Siga com a decisão normalmente.
Revisar	Amarelo	Semelhança na faixa intermediária.	Compare as imagens antes de decidir.
Divergente	Vermelho	As imagens não parecem ser da mesma pessoa.	Revisão obrigatória. Considere pedir reenvio.
Inconclusivo	Cinza	Não foi possível medir (sem rosto detectado, formato não suportado…).	Analise manualmente, como se a pré-análise não existisse.
Falha técnica	Cinza	O motor de comparação falhou.	Idem. Não invalida o cadastro.

A distância

A distância é o quanto os dois rostos diferem entre si: quanto menor, mais parecidos. Zero significa imagens idênticas.

O card também exibe os limiares da medição — os valores que separaram "confere" de "divergente" naquele momento. Eles ficam registrados junto com o resultado porque é o que dá sentido ao número: se a configuração do tenant mudar depois, a medição antiga continua explicável.

Como referência de ordem de grandeza:

Situação	Distância típica
Mesma pessoa, foto boa	próximo de 0
Mesma pessoa, documento antigo ou mal escaneado	pode subir bastante
Pessoas diferentes	bem acima do limiar de divergência

Documento ruim aumenta a distância sem haver fraude

Foto de documento antiga, plastificada, escaneada ou de baixa resolução afasta as medições — e isso não acontece de forma igual para todo mundo. É exatamente por isso que "Divergente" pede revisão em vez de reprovar. Trate o resultado como um convite a olhar, nunca como prova.

Outros campos do card

• Documento usado — qual peça serviu de referência (documento de identidade, documento bancário…).
• Rostos detectados — quantos rostos apareceram em cada imagem. Passaporte e CNH costumam ter dois (o retrato e a ghost image), o que é normal. Mais de um rosto na selfie, por outro lado, é um sinal em si — pode ser alguém segurando a foto de outra pessoa.
• Medido em e Motor — quando a medição foi feita e com qual versão do modelo, para auditoria.

Aprovação automática

Quando o tenant habilita a aprovação automática (faceMatch.autoApprove), um veredito Confere promove a conta sozinho, sem esperar o Compliance Officer abrir a tela. Nesse caso:

• a conta vai para APPROVED e o investidor é liberado imediatamente;
• a decisão fica registrada com revisado por SYSTEM_FACE_MATCH;
• o card exibe a mensagem "Esta medição aprovou a conta automaticamente";
• as notas da revisão guardam a distância, o limiar e o motor usados.

O que a aprovação automática nunca faz

• Não reprova. Nenhum veredito rejeita conta sozinho.
• Não ressuscita conta rejeitada. Só age sobre contas com status geral Pendente.
• Não sobrescreve decisão humana. Se um Compliance Officer já registrou qualquer decisão naquele investidor, o automático não age.

Auto-aprovação é independente do modo do tenant

autoApprove não respeita o modo AUTO × MANUAL: são chaves separadas. Ligada em um tenant MANUAL, ela aprova contas sem passar pelo Compliance Officer. Se a política do tenant exige decisão humana em todo caso, mantenha a auto-aprovação desligada e use a pré-análise apenas como triagem.

Quando a análise roda

• Ao enviar documentos — assim que o investidor completa o par (documento + selfie), a análise roda em segundo plano. É por aqui que a aprovação automática acontece sem depender de alguém abrir a fila.
• Ao abrir o detalhe — se ainda não houver resultado, a medição é feita na hora, em poucos segundos.

O resultado é reaproveitado: enquanto o par de imagens for o mesmo, o veredito não é recalculado. Se o investidor reenviar o documento ou a selfie, a análise refaz automaticamente.

Quando dá inconclusivo

Motivo exibido	Significado
Não há documento de identidade com foto	Falta a peça de referência.
Não há selfie enviada	Falta a prova de vida.
Nenhum rosto detectado no documento / na selfie	O detector não achou rosto na imagem.
Formato de arquivo não suportado	A pré-análise aceita JPEG e PNG. PDF não é suportado.
Não foi possível ler os arquivos	Falha ao buscar as imagens no armazenamento.
Excedeu o tempo limite / motor indisponível	Falha técnica, reprocessada automaticamente.

Documento em PDF

Se o investidor enviou a identidade como PDF, a pré-análise não consegue lê-lo e o card fica "Inconclusivo". Não é sinal de problema com o cadastro — é limitação da análise. Compare as imagens manualmente na seção Documentos do usuário.

Privacidade

A plataforma guarda apenas o veredito, a distância e o contexto da medição (qual documento foi usado, quantos rostos, quais limiares). A assinatura biométrica calculada para a comparação é descartada e nunca é armazenada.

Regras de negócio / cuidados

Atenção

• "Divergente" não é reprovação. Rejeitar a conta continua exigindo um motivo e step-up.
• "Confere" não substitui a leitura do documento. Rosto compatível não valida nome, número, validade nem autenticidade da peça.
• Compare as imagens sempre que o veredito for "Revisar" — é literalmente para isso que a faixa existe.
• Inconclusivo não é suspeita. É ausência de informação: decida com os demais painéis.

Telas relacionadas

• Detalhe e decisão
• Fila (lista)