# KYB (Know Your Business)

KYB — это процедура верификации юридических лиц, включающая проверку регистрационных данных компании, сведений о бенефициарных владельцах, деловой активности и деловой репутации с использованием ИИ-анализа открытых источников.

## Отличия KYB от KYC [#отличия-kyb-от-kyc]

| Параметр | KYC | KYB |
|----------|-----|-----|
| Объект проверки | Физическое лицо | Юридическое лицо (компания) |
| API-ключи | `kyc_live_*` / `kyc_test_*` | `kyb_live_*` / `kyb_test_*` |
| Базовый URL | `/tenant/v1/kyc/` | `/tenant/v1/kyb/` |
| Основная сущность | Applicant (заявитель) | Business (компания) |
| Результат | Личность верифицирована | Компания верифицирована |

## Функциональные возможности [#функциональные-возможности]

- **Автоматическая проверка** компании посредством ИИ-анализа открытых источников
- **Получение данных:** наименование, регистрационный номер, сведения о руководителе, бенефициарных владельцах, видах деятельности
- **Оценка рисков:** AI Confirmation Flag и Risk Score
- **Загрузка документов:** устав, свидетельство о государственной регистрации
- **Вебхуки:** уведомления о результатах верификации в режиме реального времени

## Архитектура процесса [#архитектура-процесса]

1. Тенант создаёт ссылку на верификацию через `POST /tenant/v1/kyb/verification-links`.
2. Конечный пользователь проходит KYB-поток (ввод данных компании, загрузка документов).
3. ИИ-сервис выполняет проверку компании в фоновом режиме (ориентировочное время — 2–3 минуты).
4. Тенант получает результат через вебхук `kyb.business.verified` или посредством опроса `GET /tenant/v1/kyb/businesses/external/{id}`.

## Жизненный цикл компании (Business) [#жизненный-цикл-компании-business]

```
[Создана] → [На проверке] → [Верифицирована]
                  ↓               ↓
             [Отклонена]   [На ревью]
```

**Статусы верификации:**

| Статус | Описание |
|--------|----------|
| `pending` | Компания создана, верификация ещё не завершена |
| `verified` | Компания прошла проверку |
| `rejected` | Компания отклонена (не прошла проверку) |
| `review` | Компания направлена на ручную проверку оператором |

## AI Confirmation Flag [#ai-confirmation-flag]

ИИ-сервис анализирует открытые источники (государственные реестры компаний, санкционные списки, пресс-релизы, судебные базы данных) и возвращает следующие показатели:

- **`ai_confirmation_flag`** (`true`/`false`) — подтверждение факта существования компании и соответствия указанным данным.
- **`risk_score`** (0–100) — оценка риска: более высокое значение соответствует более низкому уровню риска (аналогично оценке верификации в KYC).

Подробное описание полей результата приведено в разделе [KYB API — Справочник](/ru/kyb/api-reference).

---

> **Примечание.** KYB API находится в стадии бета-тестирования. Эндпоинты и форматы данных могут быть изменены. Рекомендуется следить за обновлениями документации.