Biometria de usuários: busca facial e lista de bloqueio

​

Como os rostos são vinculados a um usuário

​

Busca facial (1:N)

• Detecção de duplicados no onboarding — impede que a mesma pessoa crie duas contas.
• Busca reversa — identifica o usuário por trás de um quadro de CFTV ou de uma imagem em uma investigação de fraude.
• Reconhecimento de clientes recorrentes — dispensa o KYC para um cliente que retorna.

• POST /v3/face-search/ — busca facial independente

​

Detecção de duplicados

• Recusar automaticamente as sessões sinalizadas como duplicadas.
• Sinalizar para revisão — encaminhar para um analista humano.
• Apenas avisar — permitir, mas adicionar uma tag de risco.

​

Lista de bloqueio facial

​

Enviar um rosto importado para um perfil de usuário

# 1. Create or retrieve the User keyed by your vendor_data
curl -X POST https://verification.didit.me/v3/users/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "user-42",
    "display_name": "Jane Doe",
    "metadata": { "previous_provider": "legacy-kyc-vendor" }
  }'

# Response includes:
# { "didit_internal_id": "11111111-2222-3333-4444-555555555555", ... }

# 2. Upload the imported face to the User profile
curl -X POST https://verification.didit.me/v3/organization/$ORGANIZATION_ID/application/$APPLICATION_ID/vendor-users/by-id/11111111-2222-3333-4444-555555555555/faces/upload/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "<base64-encoded-jpg-or-png>",
    "comment": "Imported from previous KYC provider"
  }'

​

Como ocorre a inclusão na lista de bloqueio

​

Enviar um rosto para a lista de bloqueio

​

Remover um rosto da lista de bloqueio

​

Templates biométricos retidos após a exclusão da sessão

• Ele contém apenas o template facial numérico e os metadados de retenção. Ele nunca contém a imagem do rosto, o vídeo de prova de vida, os dados do documento, os campos de identidade extraídos, a decisão nem o id da sessão excluída.
• Ele participa da detecção de duplicatas, da Busca facial, da autenticação biométrica e das suas listas de rostos exatamente como o rosto de uma sessão ativa. As correspondências são informadas com source: "retained_template", o vendor_user_id e o vendor_data do User e um biometric_template_id.
• Ele é um dado biométrico com um expires_at definido. Ele é eliminado quando o User é excluído, quando qualquer sessão desse User é excluída com deletion_instruction: "privacy_erasure", quando expira ou quando você o elimina em Lists → Templates biométricos ou pela API de templates biométricos.
• Uma sessão criada sem vendor_data não tem um User ao qual vincular um template; ao excluí-la, é retornado ineligible_no_vendor_user e o embedding é excluído junto com a sessão.
• Templates retidos nunca entram na lista de bloqueio. Uma entrada da lista de bloqueio facial criada a partir da sessão excluída mantém sua própria entrada biométrica e seu próprio ciclo de vida, de forma independente.

​

Resumo do ciclo de vida dos rostos

​

Enviar um rosto pelo console

1. Acesse Users → [user] → Actions → Upload face.
2. Selecione uma imagem; a Didit extrai o maior rosto e armazena um novo registro de Face vinculado ao usuário.
3. O rosto é cadastrado para evidência de perfil, detecção de duplicatas e busca facial. Use a área Blocklist quando o objetivo for recusar futuras sessões com correspondência.

• Você tem uma foto de referência de um cliente verificado por um canal offline.
• Você quer pré-carregar uma lista de bloqueio com fraudadores conhecidos do seu banco de dados de fraudes.

​

Privacidade e retenção

• Embeddings faciais são vetores numéricos, não imagens. As imagens em si ficam em armazenamento de objetos criptografado, com acesso por URL assinada. Um embedding facial é um dado biométrico.
• A retenção segue a política de retenção de dados da sua aplicação. Os templates biométricos retidos seguem o período de retenção de templates biométricos, que é mais rigoroso e finito.
• Excluir uma sessão exclui a imagem e, por padrão, o embedding. Se a sua aplicação tiver optado pela retenção de templates biométricos, excluir uma sessão mantém um template sem imagem até que ele expire ou seja eliminado.
• Para uma solicitação de exclusão nos termos do direito ao esquecimento da GDPR / CCPA, exclua as sessões da pessoa com deletion_instruction: "privacy_erasure" ou exclua o User: as duas opções também eliminam todos os templates retidos. As entradas da lista de bloqueio facial que você gerencia permanecem até que você as remova.

​

Próximos passos