Перейти к основному содержанию
POST
curl

Поддержка KYC и KYB

Работает для сессий Проверки пользователей (KYC) и Верификации бизнеса (KYB). Didit сопоставляет session_id с обоими типами сессий и генерирует JWT token общего доступа, который включает:
Когда принимающий партнёр импортирует токен, Didit клонирует соответствующую сессию (KYC или KYB) вместе с её связями.

Требования

  • Сессия должна быть в завершённом статусе (APPROVED, DECLINED, IN_REVIEW).
  • У вас должна быть привилегия write:sessions.
  • for_application_id должен быть действительным приложением Didit (обычно приложением партнёра).

Примеры

Ответ:

Границы TTL

Связанные материалы

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Параметры пути

sessionId
string<uuid>
обязательно

UUID исходной сессии верификации, для которой выпускается token.

Пример:

"11111111-2222-3333-4444-555555555555"

Тело

application/json
for_application_id
string<uuid>
обязательно

UUID приложения Didit, которое погасит token. Оно должно существовать, не быть удалено и отличаться от вызывающего приложения. Его можно найти в Business Console в разделе Settings → Application.

Пример:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

ttl_in_seconds
integer
по умолчанию:3600

Срок действия token в секундах. Минимум 60, максимум 86400 (24 ч). По умолчанию 3600 (1 ч).

Требуемый диапазон: 60 <= x <= 86400
Пример:

3600

Ответ

Выпущен токен доступа.

share_token
string

JWT с подписью HS256. Передайте это значение без изменений в качестве share_token в POST /v3/session/import-shared/ в целевом приложении.

Пример:

"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

for_application_id
string<uuid>

Возвращает эхо UUID целевого приложения, к которому привязан token.

Пример:

"a5f3bca2-46e2-411e-90ef-a580900a57ee"

session_kind
enum<string>

Является ли исходная сессия сессией Проверки пользователей (KYC) или Верификации бизнеса (KYB).

Доступные опции:
user,
business
Последнее изменение 7 ноября 2026 г.