> ## 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 bloqueo de empresas: bloquear KYB y países

> Bloquea empresas en Didit por vendor_data o país, con bloqueo automático y manual. Controles KYB de fraude y sanciones con pago por llamada.

Las listas de bloqueo impiden que una empresa que no ha superado tus controles de cumplimiento, o que se encuentra en una jurisdicción peligrosa, ejecute nuevas sesiones de Verificación de empresas (KYB) o realice transacciones en tu plataforma.

## Tipos de identificadores admitidos para empresas

| Tipo | Clave | Coincide cuando… |
| - | - | - |
| Empresa | `BUSINESS` | Una nueva sesión o transacción usa el `vendor_data` incluido en la lista de bloqueo |
| País | (se configura por separado) | El país de la empresa coincide con una lista de países peligrosos |
| IP | `IP_ADDRESS` | La IP del remitente (o el rango CIDR) coincide |
| Huella digital del dispositivo | `DEVICE_FINGERPRINT` | El dispositivo del remitente coincide |
| Dirección de wallet | `WALLET_ADDRESS` | La wallet de criptomonedas vinculada a la empresa coincide |
| Cuenta bancaria | `BANK_ACCOUNT` | El IBAN o la cuenta bancaria coincide |

> [!NOTE]
>
> Las listas de bloqueo de rostros y documentos funcionan a nivel **individual** (usuario), no a nivel de empresa. Para bloquear a directores o UBO, añádelos a la lista de bloqueo como usuarios: su participación en cualquier empresa se refleja entonces en la revisión de personas clave de esa empresa.

## Cómo se produce el bloqueo

**1. Automático: en una sesión de Verificación de empresas (KYB) rechazada**

Cuando una sesión de Verificación de empresas (KYB) finaliza con el estado `Declined` y el bloqueo automático está habilitado para tu flujo, Didit cambia el estado de la empresa a `BLOCKED` y añade el `vendor_data` a la lista de bloqueo de empresas del sistema.

**2. Automático: por país peligroso**

Si el país de constitución de la empresa aparece en la lista de países peligrosos que has configurado, la sesión de Verificación de empresas (KYB) se rechaza.

**3. Automático: por entidad sancionada**

Una coincidencia de AML de la empresa que supera el umbral de rechazo rechaza automáticamente la sesión y añade la empresa a la lista de bloqueo.

**4. Manual: desde la consola**

Un analista añade una empresa a la lista de bloqueo desde *Businesses → \[empresa] → Actions → Add to blocklist*.

**5. Programático: mediante la API de listas**

Usa la [API de listas](https://docs.didit.me/es/management-api/lists/overview.md) para añadir entradas directamente a la lista de bloqueo de empresas.

## Países peligrosos

Cada aplicación incluye una lista predeterminada de **países peligrosos** (configurable desde *Settings → Blocklist → Countries*). Ejemplos de códigos ISO incluidos por defecto: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (sujeta a cambios: la lista predeterminada sigue las directrices del GAFI y de la OFAC).

Cuando se crea una empresa con un `country_code` incluido en la lista:

* La sesión de Verificación de empresas (KYB) se rechaza.
* No se emite ningún enlace de sesión.
* La entidad empresarial se crea con el estado `BLOCKED`.

## Añadir una empresa a la lista de bloqueo mediante la API

Usa la [API de listas](https://docs.didit.me/es/management-api/lists/overview.md) para añadir una entrada a la lista de bloqueo de forma programática:

1. [Obtén todas las listas](https://docs.didit.me/es/management-api/lists/list.md) filtradas por `entry_type=business` y `is_system=true` para encontrar la lista de bloqueo de empresas del sistema.
2. [Crea una entrada](https://docs.didit.me/es/management-api/lists/create-entry.md) en esa lista con `value` igual al `vendor_data` de la empresa, además de un `display_label` y un `comment` opcionales para fines de auditoría.

## Aplicación en el momento de la transacción

Las empresas incluidas en la lista de bloqueo se aplican automáticamente en la Monitorización de transacciones:

* Las transacciones con una **empresa solicitante en la lista de bloqueo** se rechazan automáticamente.
* Las transacciones con una **empresa contraparte en la lista de bloqueo** se marcan o se rechazan según la configuración de tus reglas.

Las reglas predefinidas, como "Sanctioned counterparty", se activan con estas coincidencias.

## Eliminar una empresa de la lista de bloqueo

* **Console**: *Blocklist → Businesses → acciones de la fila → Remove*.
* **API**: usa el endpoint [Delete entry](https://docs.didit.me/es/management-api/lists/delete-entry.md) con el UUID de la lista y el UUID de la entrada.

La eliminación no cambia automáticamente el `status` de la empresa. Usa `PATCH /v3/businesses/{vendor_data}/update-status/` para devolver la empresa a `ACTIVE`.

## Registro de auditoría

Cada alta o baja se registra en el [registro de auditoría](https://docs.didit.me/es/console/audit-logs.md) con:

* Autor (correo electrónico del usuario o `'system'`, `'api'`).
* Marca de tiempo.
* Comentario opcional.
* Sesión de referencia, si se generó automáticamente.

## Próximos pasos

> [card] [API de listas](https://docs.didit.me/es/management-api/lists/overview.md)
>
> Referencia completa de la API de listas de bloqueo.

> [card] [Lista de bloqueo en la consola](https://docs.didit.me/es/console/blocklist-users.md)
>
> Gestiona las listas de bloqueo desde la interfaz.

> [card] [Operaciones](https://docs.didit.me/es/entities/businesses/operations.md)
>
> Cambia el estado de la empresa.


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