A **Lista de bloqueio** permite que a sua empresa bloqueie transações Pix por conta própria, sem precisar abrir chamado com o suporte. Você define quem não pode transacionar com a sua conta — por **CPF/CNPJ** ou por **banco (ISPB)** — e escolhe se o bloqueio vale para **Pix recebido**, **Pix de saída**, ou ambos (uma entrada para cada direção).

É uma camada de proteção contra fraude: se o seu time de risco identificou um pagador, um beneficiário ou uma instituição com histórico ruim, você mesmo cadastra o bloqueio e ele passa a valer imediatamente para todas as transações da empresa.

## Onde encontrar

No menu lateral esquerdo, acesse **Segurança** e depois a aba **Listas de bloqueio**.

A página tem duas seções:

- **Lista de bloqueio** — onde você cadastra e gerencia as regras;
- **Alertas** — o histórico de transações que foram efetivamente bloqueadas pelas suas regras.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa0NhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--78e9fb1f5e4292bddfe9486036b7960ff2a29934/01-page.png)

> A página é visível para usuários com perfil de **administrador**. Se a aba não aparecer para a sua empresa, fale com o nosso suporte para habilitar o recurso.

## Como criar uma entrada na lista de bloqueio

Clique em **Adicionar**, no canto superior direito.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa0dhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--2618b05adb5e3bb33e5b639f9093b453eace84f8/02-modal-ispb.png)

Preencha os campos:

#### 1. Nome (opcional)

Um nome para identificar a regra depois, por exemplo `Bloqueio banco de risco` ou `Beneficiários reportados`. Se você não preencher, geramos um nome automático.

#### 2. Aplica-se a

- **Empresa inteira** — a regra vale para todas as contas bancárias da empresa;
- **Uma conta específica** — a regra vale apenas para a conta bancária selecionada. Ao escolher essa opção, aparece o campo **Conta bancária**.

#### 3. Bloquear por

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa09hIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--6ec6111cebe4f82c2a8dc78e8f6818b3696d4c8d/06-block-by-options.png)

- **Banco (ISPB)** — bloqueia toda a instituição financeira. Todo Pix que vier daquele banco (ou for para aquele banco, dependendo da direção) é barrado.
- **CPF/CNPJ** — bloqueia uma pessoa ou empresa específica, independentemente do banco que ela usar.

#### 4. Os valores

**Se escolheu Banco (ISPB):** basta digitar o nome do banco no campo **Bancos (ISPB)** e selecioná-lo na lista. O ISPB é preenchido automaticamente. Você pode adicionar vários bancos na mesma entrada — ou colar uma lista de ISPBs separados por vírgula ou quebra de linha.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa0thIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--3bba7e858afc4044709e2c754c77fcef0752ff7f/03-bank-picker.png)

**Se escolheu CPF/CNPJ:** informe um ou mais documentos, separados por vírgula ou por quebra de linha. Pode colar com máscara (`123.456.789-01`) — nós normalizamos para apenas números.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa1dhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b81433997fbe38f4d556fa3561874450f36adb6f/08-taxid-form.png)

> **Limites e formatos:** até **100 valores por entrada**. CPF deve ter 11 dígitos, CNPJ 14 dígitos e ISPB 8 dígitos. Valores fora do formato são apontados antes de salvar.

#### 5. Direção

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa1NhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b8b14f8beea1c2979c3ea338c031921063e1bc01/07-direction-options.png)

- **Pix recebido** — bloqueia o dinheiro que **entra**. A transação é recusada e o valor volta automaticamente para o pagador; ele nunca é creditado na sua conta.
- **Pix de saída** — bloqueia o dinheiro que **sai**. O pagamento para aquele CPF/CNPJ ou para aquela instituição não é concluído e quem estiver operando recebe uma mensagem informando que a transação não é suportada para aquele destino.

> Cada entrada cobre **uma** direção. Para bloquear entrada **e** saída do mesmo CPF/CNPJ, cadastre duas entradas.

#### 6. Descrição (opcional)

Use para registrar o motivo do bloqueio — ajuda o seu time a entender depois por que aquela regra existe.

Clique em **Adicionar** para salvar. A entrada já nasce **ativa** e passa a valer imediatamente.

## Gerenciando as entradas

A lista mostra todas as entradas da empresa, com nome, escopo, conta, tipo, valores bloqueados, se está ativa e a data de criação.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2FhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--d13abca4cd0a0983fac553475c864fc8d542fd28/09-list.png)

Cada linha tem três ações:

- **Editar** — altera o nome, a descrição e os valores bloqueados. O tipo e o escopo não podem ser alterados: para mudá-los, remova a entrada e crie outra.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3VhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--94f4755be552b40b1c0fd846c3a68f38dbb835ac/14-edit.png)

- **Desativar / Ativar** — suspende a regra sem apagá-la. Útil quando você quer testar o efeito de um bloqueio ou liberar temporariamente um parceiro.
- **Remover** — apaga a entrada definitivamente.

Clicando sobre a linha, você abre o detalhe da entrada, com todos os valores bloqueados e as informações de auditoria.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2VhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--1950aecd25e546172739adf4e57f10deb0dbc8b8/10-detail.png)

### Busca e filtros

Use o campo **Pesquisar por nome** para achar uma regra rapidamente. No botão **Filtrar** existem filtros adicionais: por **valor bloqueado** (encontre qual regra contém um CPF ou ISPB específico), por **nome**, por **tipo de regra** e por **ativo/inativo**.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa2lhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--b574bff6b760a3bda1f30bbf92900e3885515dab/11-filters.png)

## Alertas: o que foi bloqueado

A aba **Alertas** registra cada transação que suas regras barraram — data, conta bancária, valor, qual regra foi acionada, o motivo e o ID end-to-end do Pix.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa21hIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--0ad38661b81a9270a97bb00d698fd069db7c7871/12-alerts.png)

Clique em um alerta para ver o detalhe completo: o indicador de fraude que disparou, a regra responsável (com o escopo e a lista de valores vigente no momento), o nível de risco e os dados das partes envolvidas na transação.

![](https://chat.woovi.io/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBa3FhIiwiZXhwIjpudWxsLCJwdXIiOiJibG9iX2lkIn19--c3ab454281636377d8678deedb8e7985bae4c351/13-alert-detail.png)

Essa é a melhor forma de conferir se um bloqueio está funcionando como esperado e de manter o histórico para auditoria.

## Boas práticas

- **Comece pelo específico.** Bloquear um CPF/CNPJ afeta apenas aquela pessoa; bloquear um ISPB afeta **todos** os clientes daquela instituição. Use o bloqueio por banco com cuidado.
- **Sempre preencha a descrição** com o motivo e a origem da informação (denúncia, MED, análise interna). Isso evita bloqueios "órfãos" que ninguém sabe por que existem.
- **Prefira desativar antes de remover** quando estiver em dúvida — a regra fica registrada e você pode reativá-la.
- **Revise a aba Alertas periodicamente** para identificar bloqueios legítimos que estejam atrapalhando clientes reais.

## Perguntas frequentes

**O bloqueio vale a partir de quando?**
Imediatamente após salvar. Não é preciso reiniciar nada.

**O que o pagador vê quando o Pix é bloqueado na entrada?**
A transação é recusada e o valor retorna para a conta de origem pelo próprio banco do pagador. O dinheiro não passa pela sua conta.

**Posso bloquear só uma das minhas contas?**
Sim. Em **Aplica-se a**, escolha **Uma conta específica** e selecione a conta bancária.

**Quantos CPFs/CNPJs cabem em uma entrada?**
Até 100 valores por entrada. Se precisar de mais, crie entradas adicionais.

**Bloquear por CPF/CNPJ impede a pessoa de pagar minhas cobranças?**
Sim, se a entrada estiver na direção **Pix recebido**: qualquer Pix originado por aquele documento será recusado, inclusive o pagamento de uma cobrança sua.