> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Lista de bloqueio de empresas: bloqueie KYB e países

> Bloqueie empresas na Didit por vendor_data ou país, com bloqueio automático e manual. Controles KYB de fraude e sanções com pagamento por chamada.

Listas de bloqueio impedem que uma empresa reprovada nas suas verificações de conformidade, ou localizada em uma jurisdição perigosa, inicie novas sessões de Verificação de Empresas (KYB) ou realize transações na sua plataforma.

## Tipos de identificadores compatíveis para empresas

| Tipo | Chave | Corresponde quando… |
| - | - | - |
| Empresa | `BUSINESS` | Uma nova sessão ou transação usa o `vendor_data` incluído na lista de bloqueio |
| País | (configurado separadamente) | O país da empresa corresponde a uma lista de países perigosos |
| IP | `IP_ADDRESS` | O IP (ou intervalo CIDR) de quem envia corresponde |
| Impressão digital do dispositivo | `DEVICE_FINGERPRINT` | O dispositivo de quem envia corresponde |
| Endereço de carteira | `WALLET_ADDRESS` | A carteira de criptomoedas vinculada à empresa corresponde |
| Conta bancária | `BANK_ACCOUNT` | O IBAN / conta bancária corresponde |

> [!NOTE]
>
> Listas de bloqueio de rostos e documentos funcionam no nível **individual** (usuário), não no nível da empresa. Para bloquear diretores ou UBOs, inclua-os na lista de bloqueio como usuários: o envolvimento deles com qualquer empresa é então considerado na revisão de pessoas-chave da empresa.

## Como ocorre a inclusão na lista de bloqueio

**1. Automática: em uma sessão de Verificação de empresas (KYB) recusada**

Quando uma sessão de Verificação de empresas (KYB) termina como `Declined` e a inclusão automática na lista de bloqueio está ativada no seu fluxo, a Didit muda a empresa para `BLOCKED` e adiciona o `vendor_data` à lista de bloqueio de empresas do sistema.

**2. Automática: em país perigoso**

Se o país de constituição da empresa estiver na sua lista configurada de países perigosos, a sessão de Verificação de empresas (KYB) é recusada.

**3. Automática: em entidade sancionada**

Um alerta AML da empresa acima do limiar de recusa recusa automaticamente a sessão e inclui a empresa na lista de bloqueio.

**4. Manual: pelo console**

Um analista inclui uma empresa na lista de bloqueio em *Businesses → \[empresa] → Actions → Add to blocklist*.

**5. Programática: pela Lists API**

Use a [Lists API](https://docs.didit.me/pt-br/management-api/lists/overview.md) para adicionar entradas diretamente à lista de bloqueio de empresas.

## Países perigosos

Cada aplicação vem com uma lista padrão de **países perigosos** (configurável em *Settings → Blocklist → Countries*). Exemplos de códigos ISO incluídos por padrão: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (a lista padrão está sujeita a alterações e segue as orientações do FATF e do OFAC).

Quando uma empresa é criada com um `country_code` correspondente:

* A sessão de Verificação de empresas (KYB) é recusada.
* Nenhum link de sessão é emitido.
* A entidade empresarial é criada com o status `BLOCKED`.

## Adicionar uma empresa à lista de bloqueio pela API

Use a [Lists API](https://docs.didit.me/pt-br/management-api/lists/overview.md) para adicionar uma entrada à lista de bloqueio de forma programática:

1. [Liste todas as listas](https://docs.didit.me/pt-br/management-api/lists/list.md) filtrando por `entry_type=business` e `is_system=true` para encontrar a lista de bloqueio de empresas do sistema.
2. [Crie uma entrada](https://docs.didit.me/pt-br/management-api/lists/create-entry.md) nessa lista com `value` definido como o `vendor_data` da empresa, além de `display_label` e `comment` opcionais para fins de auditoria.

## Aplicação no momento da transação

Empresas na lista de bloqueio são propagadas automaticamente para o Monitoramento de transações:

* Transações com uma **empresa solicitante na lista de bloqueio** são recusadas automaticamente.
* Transações com uma **empresa contraparte na lista de bloqueio** são sinalizadas ou recusadas, dependendo da configuração das suas regras.

Regras predefinidas como "Sanctioned counterparty" são acionadas nessas correspondências.

## Remover uma empresa da lista de bloqueio

* **Console**: *Blocklist → Businesses → ações da linha → Remove*.
* **API**: use o endpoint [Delete entry](https://docs.didit.me/pt-br/management-api/lists/delete-entry.md) com o UUID da lista e o UUID da entrada.

A remoção não altera automaticamente o `status` da empresa. Use `PATCH /v3/businesses/{vendor_data}/update-status/` para mover a empresa de volta para `ACTIVE`.

## Trilha de auditoria

Cada adição e remoção é registrada no [registro de auditoria](https://docs.didit.me/pt-br/console/audit-logs.md) com:

* Responsável (e-mail do usuário ou `'system'`, `'api'`).
* Data e hora.
* Comentário opcional.
* Sessão de referência, se gerada automaticamente.

## Próximos passos

> [card] [API de listas](https://docs.didit.me/pt-br/management-api/lists/overview.md)
>
> Referência completa da API de listas de bloqueio.

> [card] [Lista de bloqueio no console](https://docs.didit.me/pt-br/console/blocklist-users.md)
>
> Gerencie listas de bloqueio pela interface.

> [card] [Operações](https://docs.didit.me/pt-br/entities/businesses/operations.md)
>
> Altere o status da empresa.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.