> ## 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: сессия, функции и AML-скрининг

> Статусы KYB в Didit: строки для сессий, функций, реестров и AML-скринингов, названия функций. От $2.00 за проверку, цена по странам и тарифам.

Business Verification (KYB) отслеживает статус на нескольких уровнях: **сессия**, отдельные **функции**, **запрос к реестру** и **результат AML**. Эта страница содержит справочник по всем состояниям.

API возвращает значения статусов как точные метки с учётом регистра, например `"In Progress"` и `"Not Finished"`. Те же строки содержатся в webhook-событиях. Сравнивайте именно эти строки, а не названия в верхнем регистре.

## Статус сессии

Общий статус сессии Business Verification (KYB). Это поле, по которому вы будете чаще всего определять дальнейшие действия.

| Статус | Значение |
| - | - |
| `"Not Started"` | Сессия создана, но компания ещё не открыла размещённую ссылку. |
| `"In Progress"` | Размещённый процесс активен: выполняются запросы к реестру, загружаются документы или проводится AML-скрининг. |
| `"Awaiting User"` | Ожидается действие конечного пользователя (обычно отправка списка ключевых лиц или ответ на запрос о повторной отправке данных). Статус меняется автоматически, когда пользователь выполняет ожидаемое действие. |
| `"Approved"` | Все обязательные функции пройдены. Компания верифицирована. |
| `"Declined"` | Не пройдена критическая проверка (ликвидированная компания, организация, находящаяся под санкциями, попадание в список блокировки) или правило сценария отклонило сессию. |
| `"In Review"` | Одна или несколько функций требуют ручной проверки аналитиком. |
| `"Resubmitted"` | Сессия, ранее отклонённая или для которой был запрошен повторный запрос данных, повторно отправлена с обновлёнными данными. |
| `"Abandoned"` | Компания так и не завершила процесс (истёк таймаут). |
| `"Expired"` | Срок действия сессии истёк до того, как компания её завершила. |

> [!NOTE]
>
> `"Awaiting User"` является временным статусом: вам не нужно вручную выводить сессии из него. Как только конечный пользователь выполняет ожидаемое действие (например, отправляет список ключевых лиц или заново загружает запрошенный документ), Didit повторно оценивает сессию и автоматически переводит её в `"In Review"`, `"Approved"` или `"Declined"` в зависимости от результата.

## Статус функции

У каждой функции KYB есть собственный статус, который сводится в общий статус сессии.

| Статус | Значение |
| - | - |
| `"Not Finished"` | Функция ещё не запущена или выполняется. |
| `"Approved"` | Функция пройдена. |
| `"Declined"` | Функция не пройдена; ошибка критическая. |
| `"In Review"` | Функции требуется внимание аналитика. |
| `"Resub Requested"` | Компании необходимо повторно отправить данные для этой функции (например, заново загрузить документ). |
| `"Awaiting User"` | Функция ожидает действия конечного пользователя. Относится к функции «Ключевые лица», пока пользователь должен отправить данные об участниках. Меняется автоматически после отправки. |

### Названия функций KYB

Это значения поля `features` в сессии KYB и в webhook:

* `KYB_REGISTRY`: проверка по реестру компаний.
* `AML`: AML-скрининг на уровне компании.
* `KYB_DOCUMENTS`: сбор документов и OCR.
* `KYB_KEY_PEOPLE`: ключевые лица: UBO, акционеры, директора, представители и другие должностные лица.

## Статус реестра (от провайдера)

Официальный статус компании по данным авторитетных реестровых источников. Отражает юридический или регуляторный статус организации в том виде, в каком его передаёт реестр конкретной юрисдикции, поэтому точные значения зависят от источника. Передаётся в решении KYB в поле `company.registry_status`.

| Статус | Значение |
| - | - |
| `ACTIVE` | Компания действует и имеет надлежащий статус. |
| `DISSOLVED` | Компания ликвидирована. |
| `DEREGISTERED` | Компания исключена из реестра. |
| `STRUCK_OFF` | Компания исключена из реестра. |
| `CLOSED` | Компания закрыта. |
| `INACTIVE` | Компания неактивна (не ведёт деятельность). |
| `AUTHORISED` | Авторизована (обычно для регулируемых организаций). |
| `APPOINTED_REPRESENTATIVE` | Назначенный представитель другой авторизованной фирмы. |
| `UNAUTHORISED` | Ранее была авторизована, теперь авторизация отсутствует. |
| `NO_LONGER_AUTHORISED` | Авторизация отозвана. |
| `SEE_FULL_DETAILS` | Статус требует ручной проверки. |

> [!NOTE]
>
> Поскольку `registry_status` отражает исходные значения реестров, используйте `verification_status` ниже, когда вам нужен единый показатель для всех юрисдикций, на основе которого строится логика продукта.

## Статус верификации компании

Стандартизированный статус результата по каждой компании, понятный бизнес-пользователю. Приводит разные статусы реестров и компаний из разных стран и источников к единому показателю, который можно напрямую использовать в вашем продукте. Передаётся в решении KYB в поле `company.verification_status`.

| Статус | Значение |
| - | - |
| `verified` | Компания выглядит действующей и имеющей надлежащий статус. |
| `failed` | Компания неактивна, ликвидирована или выявлены проблемы. |
| `unknown` | Недостаточно информации или статус неоднозначен. |

## Статус получения данных о компании

Показывает ход получения данных по конкретной записи о компании из внешних или официальных реестров. Используйте его, чтобы понять, насколько полными являются полученные сведения о компании. Передаётся в решении KYB в поле `company.fetch_status`.

| Статус | Значение |
| - | - |
| `pending` | На данный момент получены только частичные или базовые сведения о компании. |
| `resolved` | Полные данные о компании успешно получены из официальных источников. |

## Статус AML-верификации

Возвращается для каждой проверки (компании или физического лица).

| Статус | Значение |
| - | - |
| `"Approved"` | Совпадений выше порога нет. |
| `"Declined"` | Совпадение высокой степени критичности (подтверждённые санкции или совпадение с PEP). |
| `"In Review"` | Найдено совпадение, требующее проверки аналитиком. |
| `"Not Finished"` | Скрининг не завершён. |

## Как решение объясняет само себя

Решение KYB не содержит одной строки с кодом причины.
Каждый массив функций (`registry_checks[]`, `document_verifications[]`, `key_people_checks[]`, `aml_screenings[]`) содержит `warnings[]` с тегами `KYB_*` и AML, а `decision_trace` фиксирует, как было получено решение.
Изучите теги в разделе [предупреждения KYB](https://docs.didit.me/ru/business-verification/warnings.md) и записывайте их рядом со статусом сессии.

Когда проверяющий вручную устанавливает статус вопреки собственной агрегации платформы, решение содержит `status_override` со временем `overridden_at` и значением `automatic_status`, которое платформа установила бы сама.
См. [схему ответа](https://docs.didit.me/ru/business-verification/response-schema.md).

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

> [card] [Схема ответа](https://docs.didit.me/ru/business-verification/response-schema.md)
>
> Где каждый статус появляется в payload.

> [card] [Оценка рисков](https://docs.didit.me/ru/business-verification/risk-assessment.md)
>
> Что определяет результат KYB.

> [card] [Webhooks](https://docs.didit.me/ru/business-verification/webhooks.md)
>
> События, которые срабатывают при изменении статусов.


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