Blacklist (Antifraude)
Pré-requisitos de acesso
- Permissão (módulo):
manageAntifraudBlacklist - Licença/Feature: Nenhuma
- Contêiner do menu: GERAL → grupo Auditoria
O que é / quando usar
A tela Blacklist (/antifraud-blacklist) lista as carteiras e contas marcadas como suspeitas/bloqueadas para o motor antifraude. Quando uma operação tem origem ou destino na blacklist, regras de severidade crítica disparam (ex.: isFromBlacklistedSource, isPixKeyBlacklisted, to_blacklisted_destination), empurrando o score para o bloqueio automático.
Use esta tela para auditar quais endereços/contas estão bloqueados, quem incluiu e por quê.
Pré-condições
- Permissão: módulo
manageAntifraudBlacklist. Permissão é dupla — enum CPM no backend + módulo dinâmico no DB. - Licença/Feature: nenhuma.
- Dependências de outras telas: as entradas são consumidas pelo AntifraudService nas avaliações em tempo real (categoria
counterparty).
Passo a passo
Consultar
- Acesse o menu GERAL → Auditoria → Blacklist.
- A tabela carrega as entradas (paginação local: 10/20/50 por página).
- Consulte carteira, conta, quem aprovou, o motivo e a data de inclusão.
Adicionar uma entrada
- Clique em Adicionar no topo da tela para abrir o formulário.
- Informe a Carteira e a Conta (obrigatórias) e, opcionalmente, o Motivo do bloqueio.
- Clique em Salvar na blacklist.
- O sistema solicita a reautenticação (step-up) — confirme sua identidade com senha/MFA para concluir.
- O campo Bloqueado por é preenchido automaticamente com o operador autenticado.
Remover uma entrada
- Na linha desejada, clique no ícone de lixeira (coluna Ações).
- Confirme a reautenticação (step-up) quando solicitada.
- A remoção é definitiva (hard delete) e a contraparte deixa de ser bloqueada pelas regras de blacklist.
Filtros e colunas
| Filtro / Coluna | O que mostra | Origem do dado |
|---|---|---|
| Carteira | Endereço de carteira bloqueada | wallet |
| Conta | Conta associada | account |
| Aprovado por | Administrador que incluiu a entrada | approved_by |
| Motivo | Justificativa do bloqueio | reason |
| Criado em | Data/hora de inclusão (formatada pt-BR) | createdAt |
| Ações | Remover a entrada (exige step-up) | — |
Regras de negócio / cuidados
Atenção
- A blacklist é alimentada automaticamente a partir de listas de sanções públicas (OFAC — SDN List e a lista de endereços cripto sancionados). Ou seja, muitas entradas chegam sem ação manual — elas refletem sanções regulatórias.
- Bloquear um endereço/conta tem efeito crítico no antifraude: operações com aquela contraparte tendem a ser barradas automaticamente. Registre quem aprovou e o motivo em inclusões manuais — é a trilha de auditoria.
- Adicionar e remover exigem step-up (reautenticação com senha/MFA, janela de ~5 min). A mesma carteira não pode ser bloqueada duas vezes — o sistema rejeita duplicatas.
Impacto operacional
- Uma entrada de blacklist pode interromper imediatamente transações de clientes legítimos que interajam com a contraparte listada. Revise com cuidado antes de incluir manualmente e confirme se não há sobreposição indevida com a Whitelist.