> ## 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.

# Список блокировки компаний и стран для KYB

> Блокируйте компании Didit Business по vendor_data или стране: как проверяется блокировка и как добавить или удалить её через консоль и API.

Списки блокировки не позволяют компании, которая не прошла ваши проверки комплаенса, или компании, находящейся в опасной юрисдикции, запускать новые сессии верификации бизнеса (KYB) или проводить транзакции на вашей платформе.

## Поддерживаемые типы идентификаторов компаний

| Тип | Ключ | Совпадение происходит, когда… |
| - | - | - |
| Компания | `BUSINESS` | Новая сессия или транзакция использует заблокированный `vendor_data` |
| Страна | (настраивается отдельно) | Страна компании указана в списке опасных стран |
| IP | `IP_ADDRESS` | IP-адрес отправителя (или диапазон CIDR) совпадает |
| Отпечаток устройства | `DEVICE_FINGERPRINT` | Устройство отправителя совпадает |
| Адрес кошелька | `WALLET_ADDRESS` | Совпадает криптокошелёк, связанный с компанией |
| Банковский счёт | `BANK_ACCOUNT` | Совпадает IBAN или банковский счёт |

> [!NOTE]
>
> Списки блокировки по лицам и документам работают на уровне **физического лица** (User), а не компании. Чтобы заблокировать директоров или UBO, добавьте их в список блокировки как пользователей: их участие в любой компании затем передаётся в проверку ключевых лиц компании.

## Как происходит блокировка

> [!NOTE]
>
> Отклонённая сессия верификации бизнеса (KYB) не блокирует компанию. Сессия получает статус `Declined`, компания остаётся в статусе `ACTIVE`, и запись в список не создаётся. Блокировка выполняется вручную: добавьте запись на [странице списка блокировки](https://docs.didit.me/ru/console/blocklist-users.md) или через [Lists API](https://docs.didit.me/ru/management-api/lists/overview.md). Запись типа `BUSINESS` (`vendor_data`) также переводит статус компании в `BLOCKED`.

**1. Автоматически: при опасной стране**

Если страна регистрации компании входит в настроенный вами список опасных стран, сессия верификации бизнеса (KYB) отклоняется.

**2. Автоматически: при санкционной организации**

Если AML-совпадение по компании превышает порог отклонения, сессия отклоняется. Запись в список при этом не создаётся. Если вы хотите, чтобы `vendor_data` компании отклонялся и дальше, добавьте компанию в список блокировки самостоятельно.

**3. Вручную: из консоли**

Аналитик добавляет компанию в список блокировки: *Businesses → \[business] → Actions → Add to blocklist*.

**4. Программно: через Lists API**

Используйте [Lists API](https://docs.didit.me/ru/management-api/lists/overview.md), чтобы напрямую добавлять записи в список блокировки компаний.

## Опасные страны

Каждое приложение включает список **опасных стран** по умолчанию (его можно настроить в *Settings → Blocklist → Countries*). Примеры ISO-кодов, включённых по умолчанию: `IRN`, `PRK`, `SYR`, `AFG`, `RUS`, `MMR` (может меняться: список по умолчанию следует рекомендациям FATF и OFAC).

Когда компания создаётся с совпадающим `country_code`:

* Сессия верификации бизнеса (KYB) отклоняется.
* Ссылка на сессию не выдаётся.
* Объект компании создаётся в статусе `BLOCKED`.

## Добавление компании в список блокировки через API

Используйте [Lists API](https://docs.didit.me/ru/management-api/lists/overview.md), чтобы добавить запись в список блокировки программно:

1. [Получите все списки](https://docs.didit.me/ru/management-api/lists/list.md) с фильтром `entry_type=business` и `is_system=true`, чтобы найти системный список блокировки компаний.
2. [Создайте запись](https://docs.didit.me/ru/management-api/lists/create-entry.md) в этом списке, указав в `value` `vendor_data` компании, а также необязательные `display_label` и `comment` для аудита.

## Применение при проведении транзакций

Заблокированные компании автоматически передаются в Мониторинг транзакций:

* Транзакции с **заблокированной компанией-заявителем** автоматически отклоняются.
* Транзакции с **заблокированной компанией-контрагентом** помечаются или отклоняются в зависимости от настроек правил.

Встроенные правила, например «Санкционный контрагент», срабатывают на эти совпадения.

## Удаление компании из списка блокировки

* **Консоль**: *Blocklist → Businesses → row actions → Remove*.
* **API**: используйте endpoint [Delete entry](https://docs.didit.me/ru/management-api/lists/delete-entry.md) с UUID списка и UUID записи.

Удаление из списка не меняет `status` компании автоматически. Чтобы вернуть компанию в статус `ACTIVE`, используйте `PATCH /v3/businesses/{vendor_data}/update-status/`.

## Журнал аудита

Каждое добавление и удаление записывается в [журнал аудита](https://docs.didit.me/ru/console/audit-logs.md) с указанием:

* Исполнителя (адрес электронной почты пользователя или `'system'`, `'api'`).
* Времени.
* Необязательного комментария.
* Ссылки на сессию, если запись создана автоматически.

## Дальнейшие шаги

> [card] [Lists API](https://docs.didit.me/ru/management-api/lists/overview.md)
>
> Полный справочник API списков блокировки.

> [card] [Список блокировки в консоли](https://docs.didit.me/ru/console/blocklist-users.md)
>
> Управление списками блокировки в интерфейсе.

> [card] [Операции](https://docs.didit.me/ru/entities/businesses/operations.md)
>
> Изменение статуса компании.


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