Перейти к основному содержанию
GET
Получить дополнительную проверку (step-up)
Аутентификация появилась недавно. Эти endpoint обслуживаются эмитентом вашего приложения, например https://<name>.auth.didit.me, и никогда не принимают ваш API-ключ Didit.
Step-up принадлежит сессии, которая его создала: токен доступа другой сессии получает 404. Step-up в статусе pending отображается как expired по истечении 30 минут.

Авторизации

Authorization
string
header
обязательно

Токен доступа человека из POST /token/: JWT с алгоритмом ES256 и заголовком typ: at+jwt, действующий не более 5 минут. Не ваш API-ключ Didit.

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

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

Значение id из POST /step-up/, также являющееся параметром запроса step_up в вашем return_to. Если значение не является UUID, возвращается страница с ошибкой 404, а не JSON.

Ответ

Дополнительная проверка (step-up).

Верификация, которую человек должен пройти перед совершением действия.

id
string<uuid>
обязательно
Пример:

"94efc2c3-ca84-42fe-900b-6fb61669a7a1"

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

Правило, которое запросило это действие. Если применимо несколько правил, выбирается правило с самым строгим методом.

Доступные опции:
payout,
device,
bank,
contact
Пример:

"payout"

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

Что делает пользователь: liveness, selfie (проверка живости со сравнением с лицом, которое уже есть у Didit) или full_id (документ и селфи). Если у Didit ещё нет лица пользователя, selfie переходит в full_id, как только пользователь открывает verification_url.

Доступные опции:
liveness,
selfie,
full_id
Пример:

"selfie"

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

Действуйте только при статусе approved. Статус review ожидает проверки вашей командой. Статус declined не является окончательным, пока действует verification_url: пользователь может повторить попытку, и повторная проверка вернётся в статус pending. Статус superseded означает, что другая проверка перехватила эту верификацию либо результат относился не к этой повторной проверке: создайте новую.

Доступные опции:
pending,
review,
approved,
declined,
expired,
superseded
Пример:

"pending"

level
enum<string> | null
обязательно

Уровень, достигнутый верификацией после её одобрения.

Доступные опции:
liveness,
liveness_face_match,
full_id,
null
Пример:

null

amount
string | null
обязательно

Сумма выплаты, два знака после запятой.

Пример:

"900.00"

currency
string | null
обязательно
Пример:

"USD"

created_at
string<date-time>
обязательно
Пример:

"2026-10-17T10:41:14.894632Z"

completed_at
string<date-time> | null
обязательно
Пример:

null

expires_at
string<date-time>
обязательно

30 минут после создания. При чтении step-up сначала запрашивается любой результат, которого достигла его верификация, поэтому по истечении этого времени он всё ещё может возвращать approved, review или declined; если результат всё ещё pending, возвращается expired.

Пример:

"2026-10-17T11:11:14.894581Z"

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