Como comparar dois rostos com Toden
Charles Archibong, Cofundador
Compare duas fotos de rostos quando precisar de uma verificação de similaridade 1:1. Essa verificação é independente da verificação de presença e da busca em um cadastro de clientes.
Pontos principais
- As opções de correspondência, revisão, ausência de correspondência e ausência de resultado no ambiente de testes (sandbox) são tratadas separadamente.
- Os requisitos de consentimento e tamanho das fotos são aplicados.
- O aplicativo armazena e lê novamente o ID do cheque.
- Um veredicto simulado nunca é apresentado como resultado de um motor de jogo em tempo real.
Compare duas fotos de rostos quando precisar de uma verificação de similaridade 1:1. Essa verificação é independente da verificação de presença e da busca em um cadastro de clientes.
Antes de começar
Duas fotos nítidas do rosto
Autorização e consentimento para comparar as fotos.
Use um membro da equipe com permissão para este controle. Verifique a organização e o ambiente antes de alterar qualquer configuração. Revise o preço atual antes de efetuar um pagamento ou renovar a assinatura. As capturas de tela mostram um exemplo de espaço de trabalho ou a referência de integração pública; elas não mostram um cliente real nem um pagamento efetuado.
Configure e utilize a funcionalidade.
Passo 1: Abra o aplicativo Face Match e escolha o ambiente.
No painel de controle, abra Verificação → Verificações Pontuais → Correspondência Facial . Escolha Sandbox para o seu primeiro teste. Verifique se as Verificações Pontuais estão disponíveis para a sua organização e se a sua função pode executar a comparação. O aplicativo independente API Utiliza o mesmo mecanismo e histórico de veredictos. O Sandbox retorna resultados simulados; não pode comprovar a precisão da correspondência com fotos reais.
Referência de integração: Comportamento do Sandbox
Passo 2: Prepare duas fotos diferentes e nítidas.
Use duas fotos com consentimento e em que o rosto esteja legível em cada uma delas. JPEG , PNG Os formatos WebP e outros são suportados. Não envie a mesma foto duas vezes. Carregue cada foto em sua respectiva seção do formulário de reconhecimento facial e confirme a necessidade de consentimento. Analise os limites da organização exibidos, em vez de esperar que um limite por solicitação substitua a política registrada.
Referência de integração: Comparar
Etapa 3: Revise os limites e execute a comparação.
Verifique o limite de correspondência e o piso de revisão da sua organização antes de executar uma comparação de produção paga. Execute a verificação de duas fotos uma única vez e guarde o ID da verificação. Uma correspondência é o veredicto de similaridade do mecanismo no limite registrado; isso não prova que a pessoa está ativa ou controla uma conta. Quando for necessária uma revisão manual, compare as fotos e registre sua decisão de política separadamente.
Referência de integração: O veredicto
Passo 4: Integre a mesma comparação no seu backend.
Chamar POST /api/kyc/face/compare usando uma chave secreta e consentimento: true . Forneça exatamente uma fonte de foto para cada lado: imageA ou mediaAId e imageB ou mediaBId . Uma imagem pode ser pública e compatível. URL , dados URI ou base64. Para arquivos reutilizáveis, faça o upload através de POST Use a API /api/kyc/face/upload e passe os IDs de mídia. Mantenha as entradas biométricas e as chaves secretas no servidor.
Referência de integração: Carregar primeiro (opcional)
Etapa 5: Lide com todos os quatro veredictos
Leia o veredicto do faceCheck , o nível de confiança e os limites registrados nessa verificação. Uma correspondência significa que o resultado está no nível de aprovação ou acima dele; uma revisão significa que o resultado está entre o mínimo e o mínimo; e uma não correspondência significa que o resultado está abaixo do mínimo. A ausência de resultado significa que nenhuma comparação pôde ser feita e não há cobrança. Não considere uma revisão ou uma falha de serviço como uma correspondência. Uma comparação concluída sem correspondência ainda pode ser cobrada.
Referência de integração: O veredicto
Etapa 6: Utilize o histórico para conciliar e auditar
Armazene o ID da verificação associado à ação pretendida no aplicativo. Recupere. GET /api/kyc/face/checks/{id} após uma resposta perdida ou ao revisar uma comparação anterior. O endpoint de histórico filtra por veredicto e data e identifica API Verificações iniciadas. Reler um resultado existente é diferente de executar outra comparação; não repita cegamente uma verificação paga para encontrar seu resultado anterior.
Referência de integração: Histórico
Tire o máximo proveito dessa capacidade.
Defina limites de revisão como política organizacional e mantenha esses limites registrados para cada veredicto.
Use IDs de upload quando tiver uma necessidade legítima de reutilizar uma foto autorizada, em vez de transmitir repetidamente arquivos grandes em linha.
Combine isso com a vinculação do titular da conta e uma verificação presencial quando a ação exigir a confirmação do titular da conta.
Faça o teste antes de confiar nele.
Execute os cenários de Sandbox ou simulador compatíveis com este produto. Quando uma ferramenta for exclusiva para Produção, verifique primeiro o acesso e o escopo e, em seguida, use apenas um teste de Produção permitido e cuidadosamente revisado. Uma captura de tela da documentação ou o carregamento bem-sucedido de uma página não constituem um teste de integração de ponta a ponta.
As opções de correspondência, revisão, ausência de correspondência e ausência de resultado no ambiente de testes (sandbox) são tratadas separadamente.
Os requisitos de consentimento e tamanho das fotos são aplicados.
O aplicativo armazena e lê novamente o ID do cheque.
Um veredicto simulado nunca é apresentado como resultado de um motor de jogo em tempo real.
Solução de problemas
O API rejeita uma foto URL
Verifique se ele resolve para um endereço público permitido e se fornece bytes legíveis e suportados.
O resultado é nenhum resultado.
Utilize a explicação do erro e melhore a captura. Isso não é um caso de "no_match" e não será cobrado.
Uma chave publicável é recusada.
A comparação facial independente requer apenas uma chave secreta. Chame-a no seu servidor.
Abra as referências de configuração e integração.
Abra a ferramenta de painel de controle. (abre num novo separador)
Leia a referência de integração. (abre num novo separador)
Voltar para Soluções (abre num novo separador) . Escolha a funcionalidade que deseja ativar e siga o guia correspondente.
Fontes
Charles Archibong
Cofundador
Charles Archibong é cofundador da Toden. Ele escreve sobre verificação de identidade, tecnologia financeira e o trabalho prático de construção de serviços digitais confiáveis.
