API обновления сессии: исправление полей KYC и KYB

​

Общие требования

• Авторизация: клиентский API-ключ (стандартный x-api-key или Authorization с bearer-токеном) или токен авторизации пользователя.
• Привилегия:
  • KYC и POA: write:sessions
  • KYB (компания) и участник «ключевые лица»: write:businesses
• Статус сессии (только для KYC и POA): должен быть одним из APPROVED, DECLINED, IN_REVIEW или KYC_EXPIRED. Сессии, которые ещё не достигли состояния, допускающего проверку, изменить нельзя. Обновления компании KYB не ограничены статусом.
• Запись о функции должна существовать: поля KYC можно изменить, только если сессия содержит KYC, поля POA, только если сессия содержит POA, а поля компании KYB, только если в сессии есть проверка по реестру.
• Частичные обновления: изменяются только переданные поля. Чтобы оставить поле без изменений, не включайте его. Отправьте null, чтобы очистить ключ extra_fields.
• Вебхуки: успешное обновление отправляет data.updated с session_kind: "user" или "business", а журнал аудита сессии фиксирует, какие конкретные поля были изменены и кем.

​

Обновление данных идентификации KYC

​

Изменяемые поля

​

Пример

curl -X PATCH "https://verification.didit.me/v3/session/4c5c7f3a.../update-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "date_of_birth": "1990-01-01",
    "issuing_state": "ESP",
    "extra_fields": { "municipality": "Madrid" }
  }'

​

Обновление данных подтверждения адреса (POA)

​

Изменяемые поля

​

Пример

curl -X PATCH "https://verification.didit.me/v3/session/4c5c7f3a.../update-poa-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "utility_bill",
    "issuer": "Iberdrola",
    "issue_date": "2026-03-15",
    "name_on_document": "Jane Doe",
    "poa_parsed_address": {
      "street_1": "Calle Mayor 10",
      "city": "Madrid",
      "postal_code": "28013",
      "country": "ES"
    }
  }'

​

Обновление данных компании KYB

​

Требования

• Привилегия: write:businesses (отличается от привилегии для KYC и POA).
• companyUuid в URL должен принадлежать указанной sessionId, иначе вернётся 404.
• Ограничения по статусу сессии нет: данные компании KYB можно исправить в любое время.

​

Изменяемые поля

​

Пример

curl -X PATCH "https://verification.didit.me/v3/session/bs-01HJX1.../kyb/f7a9c1b2-4e6d.../update-data/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme Corporation Limited",
    "registration_number": "12345678",
    "registry_status": "active",
    "legal_address": "1 Main Street, London EC1A 1AA, United Kingdom",
    "alternative_names": "Acme Ltd, Acme Group"
  }'

​

Пропуск стороны Key People

​

Требования

• Привилегия: write:businesses.
• partyUuid в URL должен принадлежать указанной sessionId, иначе вернётся 404.
• Не ограничивается allow_skip. Эта настройка роли ограничивает, какие элементы заявитель может пропустить при заполнении размещённого экрана Key People. Данный endpoint является переопределением для оператора, поэтому он работает даже для ролей, в которых заявитель не мог бы пропустить сторону.

​

Тело запроса

​

Пример

curl -X PATCH "https://verification.didit.me/v3/session/bs-01HJX1.../kyb/parties/0a3f1e2c-7c2f.../" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "is_skipped": true }'

​

Что происходит после обновления

• Вебхук: data.updated срабатывает для сессии, а в payload передаётся session_kind сессии ("user" или "business"). Подпишитесь один раз на уровне адреса назначения webhook и выполняйте маршрутизацию по session_kind.
• Журнал аудита: сессия фиксирует, какие поля изменились, их предыдущие и новые значения, а также (для вызовов с аутентификацией пользователя) адрес e-mail исполнителя. Просмотреть это можно на вкладке Events в консоли.
• Повторное геокодирование адреса: для обновлений KYC и POA, которые меняют address / poa_address, Didit повторно запускает геокодирование в фоновом режиме. Ошибки подавляются, поэтому обновление никогда не завершается ошибкой из-за проблемы геокодирования.
• Повторная оценка AML: обновления KYC, которые меняют имя, дату рождения или гражданство, могут повторно запустить AML-скрининг, если AML для сессии ещё не завершился. Результаты появляются в решении по сессии.

​

Когда эти endpoint не подходят

• Повторный запуск всей верификации: если клиенту нужно заново снять фото документа или загрузить документ, используйте update-status, чтобы перевести сессию в Resubmitted.
• Изменение полей профиля у сущности User или Business: используйте PATCH /v3/users/{vendor_data}/ или PATCH /v3/businesses/{vendor_data}/. Эти endpoint работают с данными уровня сущности, а не сессии.
• Редактирование данных Key People: публичного API для изменения имени, ролей или структуры владения стороны нет. Эти данные передаются через размещённую страницу верификации. Единственное изменяемое поле: is_skipped (см. Пропуск стороны Key People).

​

Ошибки

​

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