Бизнес-операции: CRUD для KYB-компаний

Все операции с сущностями компаний выполняются через шесть публичных endpoint под /v3/businesses/. Эта страница даёт концептуальный обзор. Полные схемы запросов и ответов см. в справочнике API.

Получить список компаний

GET /v3/businesses/ Постраничный список компаний вашего приложения с фильтрами по статусу, поиску, стране и диапазону дат.

curl -G https://verification.didit.me/v3/businesses/ \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "status=ACTIVE" \
  --data-urlencode "country_code=GBR" \
  --data-urlencode "page_size=50"

Получить компанию

GET /v3/businesses/{vendor_data}/ Получите одну компанию по vendor_data.

curl https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY"

Создать компанию

POST /v3/businesses/create/ Заранее создайте компанию до запуска любой сессии верификации бизнеса (KYB):

curl -X POST https://verification.didit.me/v3/businesses/create/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "vendor_data": "biz-acme",
    "display_name": "Acme Corp",
    "country_code": "GBR",
    "metadata": { "partner": "Acme Holdings" }
  }'

Если компания с таким vendor_data уже существует, вернётся ошибка конфликта. Чтобы обновить существующую компанию, используйте PATCH.

Обновить компанию

PATCH /v3/businesses/{vendor_data}/ Обновите изменяемые поля профиля. Поля, полученные из реестра (legal_name, registration_number, country_code), доступны только для чтения после верификации, но их можно переопределить. Переопределения отмечаются в журнале аудита. Изменяемые поля: display_name, metadata, tags. Только для чтения после верификации: все поля, полученные из реестра, агрегированные счётчики и карта features.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "metadata": { "tier": "enterprise" } }'

Генерирует событие business.data.updated.

Изменить статус

PATCH /v3/businesses/{vendor_data}/update-status/ Переведите компанию между статусами ACTIVE, FLAGGED и BLOCKED.

curl -X PATCH https://verification.didit.me/v3/businesses/biz-acme/update-status/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "BLOCKED",
    "reason": "Sanctioned subsidiary detected in ownership chain"
  }'

Из → в	Типичный триггер
`ACTIVE` → `FLAGGED`	Сессия верификации бизнеса (KYB) перешла в статус `In Review`, срабатывание при постоянном AML-мониторинге, правило для транзакций
`ACTIVE` → `BLOCKED`	Подтверждённая санкционная организация, ручное добавление в список блокировки
`FLAGGED` → `ACTIVE`	Аналитик завершил проверку и снял флаг
`BLOCKED` → `ACTIVE`	Ручная разблокировка после устранения причины

Генерирует событие business.status.updated.

Удалить компании (пакетно)

POST /v3/businesses/delete/ Удаляет одну или несколько компаний. Записи о компаниях удаляются безвозвратно. Сессии верификации этим endpoint не затрагиваются: они сохраняются, но связь с компанией у них удаляется. Удалите их с помощью удаления сессии. Транзакции этим endpoint также не затрагиваются: удалите их в Console.

curl -X POST https://verification.didit.me/v3/businesses/delete/ \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "vendor_data": ["biz-acme", "biz-alpha", "biz-beta"] }'

Операция идемпотентна: удаление уже удалённой компании ничего не меняет.

Модель разрешений

Все endpoint /v3/businesses/* ограничены ресурсом разрешений businesses:

Роль	list	get	create	update	update-status	delete
OWNER	✅	✅	✅	✅	✅	✅
ADMIN	✅	✅	✅	✅	✅	✅
COMPLIANCE_OFFICER	✅	✅	❌	✅	✅	❌
DEVELOPER	✅	✅	✅	❌	❌	❌
READER	✅	✅	❌	❌	❌	❌

См. роли и разрешения.

Webhook, которые срабатывают при этих операциях

Операция	Webhook
`create`	`business.data.updated`
`update`	`business.data.updated` с `changed_fields`
`update-status`	`business.status.updated`
`delete`	`business.data.updated` с заполненным `deleted_at`

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

Модель данных

Полный справочник полей.

API списка

Схема GET /v3/businesses/.

API создания

Схема POST /v3/businesses/create/.

Последнее изменение 7 ноября 2026 г.

Обзор

Цены

Сценарии и верификация

Проверка и операции

Сущности (пользователи и компании)

Настройки и кастомизация

Безопасность и комплаенс

Didit Academy

Ресурсы

Бизнес-операции: CRUD для KYB-компаний

Получить список компаний

Получить компанию

Создать компанию

Обновить компанию

Изменить статус

Удалить компании (пакетно)

Модель разрешений

Webhook, которые срабатывают при этих операциях

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

Модель данных

API списка

API создания

​Получить список компаний

​Получить компанию

​Создать компанию

​Обновить компанию

​Изменить статус

​Удалить компании (пакетно)

​Модель разрешений

​Webhook, которые срабатывают при этих операциях

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

Модель данных

API списка

API создания

Получить список компаний

Получить компанию

Создать компанию

Обновить компанию

Изменить статус

Удалить компании (пакетно)

Модель разрешений

Webhook, которые срабатывают при этих операциях

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