KYB API
KYB (Know Your Business)
Обновлено:
KYB — это процедура верификации юридических лиц, включающая проверку регистрационных данных компании, сведений о бенефициарных владельцах, деловой активности и деловой репутации с использованием ИИ-анализа открытых источников.
Отличия 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
- Загрузка документов: устав, свидетельство о государственной регистрации
- Вебхуки: уведомления о результатах верификации в режиме реального времени
Архитектура процесса
- Тенант создаёт ссылку на верификацию через
POST /tenant/v1/kyb/verification-links. - Конечный пользователь проходит KYB-поток (ввод данных компании, загрузка документов).
- ИИ-сервис выполняет проверку компании в фоновом режиме (ориентировочное время — 2–3 минуты).
- Тенант получает результат через вебхук
kyb.business.verifiedили посредством опросаGET /tenant/v1/kyb/businesses/external/{id}.
Жизненный цикл компании (Business)
[Создана] → [На проверке] → [Верифицирована]
↓ ↓
[Отклонена] [На ревью]Статусы верификации:
| Статус | Описание |
|---|---|
pending | Компания создана, верификация ещё не завершена |
verified | Компания прошла проверку |
rejected | Компания отклонена (не прошла проверку) |
review | Компания направлена на ручную проверку оператором |
AI Confirmation Flag
ИИ-сервис анализирует открытые источники (государственные реестры компаний, санкционные списки, пресс-релизы, судебные базы данных) и возвращает следующие показатели:
ai_confirmation_flag(true/false) — подтверждение факта существования компании и соответствия указанным данным.risk_score(0–100) — оценка риска: более высокое значение соответствует более низкому уровню риска (аналогично оценке верификации в KYC).
Подробное описание полей результата приведено в разделе KYB API — Справочник.
Примечание. KYB API находится в стадии бета-тестирования. Эндпоинты и форматы данных могут быть изменены. Рекомендуется следить за обновлениями документации.