Saltar para o conteúdo principal
As listas de bloqueio impedem que utilizadores que não foram aprovados nas verificações de conformidade criem novas sessões ou executem novas transações. A Didit suporta listas de bloqueio por tipo de identificador, para que possa bloquear o mesmo agente mal-intencionado com base em vários pontos de dados (rosto, documento, e-mail, telefone, vendor_data do utilizador).

​
Tipos de identificadores suportados para utilizadores

Cada tipo de identificador é aplicado no ponto de contacto natural:
  • Face e documento: aplicados durante uma nova sessão.
  • E-mail e telefone: aplicados durante uma etapa da sessão que os recolhe, ou durante o payload de uma transação.
  • IP e dispositivo: aplicados durante a Análise de dispositivo e IP numa sessão.
  • vendor_data do utilizador: aplicado durante a criação da sessão ou da transação.

​
Como acontece o bloqueio

Uma sessão recusada não bloqueia ninguém. A sessão termina com o estado Declined, o utilizador mantém-se ACTIVE e não é criada nenhuma entrada na lista, pelo que a mesma pessoa pode iniciar outra sessão. O bloqueio é um passo manual: adicione a entrada a partir da página da lista de bloqueio ou com a Lists API. Uma entrada USER (o vendor_data do utilizador) também define o estado do utilizador como BLOCKED.
1

Automático: na 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.
2

Manual: a partir da Consola

Um analista bloqueia um utilizador a partir de Users → [user] → Actions → Add to blocklist, escolhendo um ou mais identificadores a capturar.
3

Programático: através da Lists API

Use a Lists API para adicionar entradas programaticamente. É a mesma API que a Consola utiliza internamente.

​
Listas do sistema e listas personalizadas

Cada aplicação tem listas de bloqueio do sistema, uma por tipo de identificador, que a Didit gere automaticamente. Não pode mudar-lhes o nome nem eliminá-las. As listas personalizadas são suas para criar, dar nome e definir o âmbito.

​
Adicionar um utilizador à lista de bloqueio através da API

Use a Lists API para adicionar uma entrada à lista de bloqueio. Para bloquear um utilizador pelo vendor_data, adicione uma entrada do tipo USER à lista de bloqueio correspondente:
  1. Liste todas as listas filtradas por entry_type=user e is_system=true para encontrar a lista de bloqueio de utilizadores do sistema.
  2. Crie uma entrada nessa lista, com value definido como o vendor_data do utilizador.
Para bloquear um utilizador por rosto, consulte Faces e biometria. Para bloquear por e-mail, telefone, documento ou IP, use a lista de bloqueio do sistema correspondente, com o identificador adequado em value.

​
Fluxo de aplicação

Nas listas de bloqueio de rostos e documentos, a verificação acontece na etapa de verificação:

​
Remover da lista de bloqueio

  • Consola: Blocklist → [type] → row actions → Remove.
  • API: use o endpoint Eliminar entrada com o UUID da lista e o UUID da entrada.
Remover a entrada não devolve automaticamente o utilizador ao estado ACTIVE. Use PATCH /v3/users/{vendor_data}/update-status/ para alterar o estado se quiser permitir novas sessões.

​
Registo de auditoria da lista de bloqueio

Todas as adições e remoções numa lista de bloqueio são registadas no registo de auditoria:
  • Quem adicionou a entrada (e-mail do utilizador ou 'system', 'api').
  • Quando.
  • comment opcional, que explica o motivo.
  • Sessão ou transação associada, se a entrada tiver sido gerada automaticamente.

​
Próximos passos

Lists API

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

Lista de bloqueio na Consola

Faça a gestão das listas de bloqueio a partir da interface.

Faces e biometria

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