Перейти к основному содержанию
POST
curl
Используйте этот способ, если предыдущая ссылка не работает: сессия была удалена или истекла до того, как человек ее начал. Удаленные сессии подходят даже в том случае, если человек уже начал или завершил верификацию. Импортированные сессии не подходят по истечении срока: они должны быть удалены. Сессия, которая не удалена и которую человек уже начал, по истечении срока не подходит. Новая сессия привязывается к тому же участнику, поэтому ее результат попадает в проверку ключевых лиц так же, как попал бы результат исходной сессии. Ссылка действует в течение срока, заданного для сессии сценария KYC, который она запускает (от 1 часа до 4 недель), а не в течение срока бизнес-сессии. Сведения об участнике и его дочерних сессиях смотрите в решении по бизнес-сессии. Если человека вообще не нужно верифицировать, вместо этого пропустите участника. О том, как устроены участники и их верификации, читайте в разделе Ключевые лица.

Авторизации

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 родительской сессии Верификации бизнеса (KYB).

Пример:

"33333333-4444-5555-6666-777777777777"

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

UUID участника в разделе «Ключевые лица» (key_people_checks[].submitted.parties[].uuid в решении по бизнес-сессии). Должен принадлежать сессии, указанной в sessionId.

Пример:

"0a3f1e2c-7c2f-4a1b-9d55-2f8d2a5d6b41"

Ответ

Создана новая KYC-сессия. Возвращает обновлённую сторону с её новой дочерней сессией, срок действия которой истекает в соответствии со временем истечения сессии KYC-сценария.

Сторона из числа ключевых лиц сессии Верификации бизнеса (KYB) с её дочерней верификацией. Та же сторона отображается в key_people_checks[].submitted.parties[] решения по сессии компании.

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

Идентификатор стороны.

entity_type
enum<string>
обязательно

Является ли сторона физическим лицом или компанией.

Доступные опции:
person,
company
source
enum<string>
обязательно

REGISTRY: получено из реестра компаний. USER: введено на экране «Ключевые лица».

Доступные опции:
REGISTRY,
USER
name
string
обязательно

Отображаемое имя стороны.

is_active
boolean
обязательно

Является ли сторона активной.

is_skipped
boolean
обязательно

Освобождена ли сторона от верификации. Повторная генерация сбрасывает это значение.

requires_verification
boolean
обязательно

Требуют ли правила, касающиеся роли и структуры владения, проведения верификации для этой стороны.

roles
object[]
обязательно

Роли, которые сторона занимает в компании.

kyc_session_deleted
boolean
обязательно

Дочерняя сессия KYC была удалена, поэтому она никогда не сможет завершиться.

kyb_sub_session_deleted
boolean
обязательно

Аналог kyc_session_deleted для компаний.

first_name
string | null

Имя (физические лица).

last_name
string | null

Фамилия (физические лица).

company_name
string | null

Название компании (стороны-компании).

registration_number
string | null

Регистрационный номер компании (стороны-компании).

email
string<email> | null

Адрес электронной почты, на который отправляется ссылка на верификацию.

nationality
string | null

Гражданство для физических лиц, страна регистрации для компаний.

phone_number
string | null

Номер телефона, полученный для стороны.

date_of_birth
string<date> | null

Дата рождения (физические лица).

position
string | null

Название должности в виде произвольного текста (физические лица).

custom_fields
object

Пользовательские поля, определённые сценарием и собранные для стороны, с ключами, соответствующими ключам полей.

kyc_session_id
string<uuid> | null

Дочерняя индивидуальная сессия KYC (физические лица).

kyc_session_status
enum<string> | null

Статус дочерней KYC-сессии. Удалённая сессия сохраняет статус, который у неё был на момент удаления.

Доступные опции:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyc_session_url
string<uri> | null

Размещённая ссылка дочерней сессии KYC. null, если ссылка отсутствует или была удалена, а также для ограниченного API-ключа без права sessions: write.

kyb_sub_session_id
string<uuid> | null

Дочерняя сессия KYB (стороны, являющиеся компаниями).

kyb_sub_session_status
enum<string> | null

Статус дочерней KYB-сессии.

Доступные опции:
Not Started,
In Progress,
Approved,
Declined,
In Review,
Expired,
Abandoned,
Kyc Expired,
Resubmitted,
Awaiting User,
null
kyb_sub_session_url
string<uri> | null

Размещённая ссылка дочерней сессии KYB с теми же правилами для null, что и у kyc_session_url.

verification_workflow_type
enum<string> | null

Тип сценария, который запускает дочерняя сессия.

Доступные опции:
kyc,
kyb,
adaptive_age_verification,
biometric_authentication,
address_verification,
questionnaire_verification,
email_verification,
phone_verification,
null
verification_workflow_id
string<uuid> | null

Сценарий, который выполняет дочерняя сессия.

verification_workflow_label
string | null

Метка этого сценария.

verification_workflow_features
object[] | null

Функции сценария дочерней сессии с их текущим статусом.

didit_internal_id
string<uuid> | null

Идентификатор верифицированного лица в Didit, когда он известен.

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