Pular para o conteúdo principal
As listas de bloqueio impedem que usuários reprovados nas suas verificações de conformidade criem novas sessões ou realizem novas transações. A Didit organiza as listas de bloqueio por tipo de identificador, para que você possa bloquear o mesmo agente mal-intencionado em vários pontos de dados (rosto, documento, e-mail, telefone, vendor_data do usuário).

​
Tipos de identificador compatíveis para usuários

Cada tipo de identificador é aplicado no momento apropriado:
  • Rosto e documento: aplicados durante uma nova sessão.
  • E-mail e telefone: aplicados durante uma etapa da sessão que os coleta ou no payload de uma transação.
  • IP e dispositivo: aplicados durante a Análise de dispositivo e IP em uma sessão.
  • vendor_data do usuário: aplicado durante a criação da sessão ou da transação.

​
Como ocorre a inclusão na lista de bloqueio

1

Automática: em uma sessão recusada

Quando uma sessão é recusada e a configuração de inclusão automática na lista de bloqueio do seu fluxo de verificação (workflow) está ativada, a Didit adiciona automaticamente os identificadores relevantes (rosto, documento, e-mail, telefone) às listas de bloqueio do sistema correspondentes e altera o status do usuário para BLOCKED.
2

Automática: em uma correspondência com a lista de bloqueio

Quando uma sessão recebida corresponde a uma entrada existente na lista de bloqueio, a sessão é recusada automaticamente com um código de motivo como blocked_face, blocked_document, blocked_email etc.
3

Manual: pelo console

Um analista inclui um usuário na lista de bloqueio em Users → [user] → Actions → Add to blocklist, escolhendo um ou mais identificadores a registrar.
4

Programática: pela API de listas

Use a API de listas para adicionar entradas de forma programática. É a mesma API que o console usa internamente.

​
Listas do sistema e listas personalizadas

Toda aplicação tem listas de bloqueio do sistema, uma por tipo de identificador, gerenciadas automaticamente pela Didit. Não é possível renomeá-las nem excluí-las. Você pode criar, nomear e definir o escopo das listas personalizadas.

​
Adicionar um usuário à lista de bloqueio pela API

Use a API de listas para adicionar uma entrada à lista de bloqueio. Para bloquear um usuário pelo vendor_data, adicione uma entrada do tipo USER à lista de bloqueio correspondente:
  1. Liste todas as listas com os filtros entry_type=user e is_system=true para encontrar a lista de bloqueio de usuários do sistema.
  2. Crie uma entrada nessa lista com value definido como o vendor_data do usuário.
Para bloquear um usuário por reconhecimento facial, consulte Faces e biometria. Para bloquear por e-mail, telefone, documento ou IP, use a lista de bloqueio do sistema correspondente com o identificador apropriado em value.

​
Fluxo de aplicação

Para as listas de bloqueio de rostos e de documentos, a verificação ocorre na etapa de verificação:

​
Remover da lista de bloqueio

  • Console: Blocklist → [type] → row actions → Remove.
  • API: use o endpoint Excluir entrada com o UUID da lista e o UUID da entrada.
A remoção da entrada não altera automaticamente o status do usuário para ACTIVE. Use PATCH /v3/users/{vendor_data}/update-status/ para alterar o status se quiser permitir novas sessões.

​
Trilha de auditoria da lista de bloqueio

Toda inclusão ou remoção em uma lista de bloqueio é registrada no registro de auditoria:
  • Quem adicionou a entrada (e-mail do usuário ou 'system', 'api').
  • Quando.
  • Um comment opcional explicando o motivo.
  • A sessão ou transação vinculada, se a entrada foi gerada automaticamente.

​
Próximos passos

API de listas

Referência completa da API de listas de bloqueio e de permissões.

Lista de bloqueio no console

Gerencie as listas de bloqueio pela interface.

Faces e biometria

Como funcionam as listas de bloqueio de rostos.
Última modificação em 1 de novembro de 2026