Перейти к основному содержанию
GET
curl
Endpoint Get a Bank Link возвращает статус связи и, после её завершения, её connection_id и check_id. Вызывайте его со своего сервера после onSuccess или по событию bank.link.completed: никогда не доверяйте идентификатору связи, переданному браузером. Для неудачной связи возвращается ответ 200 со значением status: failed и полем error с кодом, например duplicate_conflict или reduced_grant.

Авторизации

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

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

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

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

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

Ответ

Ссылка.

Один запуск Bank Link для одного пользователя: подключение банка или продление подключения. Подтверждайте ссылку сами с помощью get_link: никогда не доверяйте идентификатору, присланному браузером.

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

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

mode
enum<string>
обязательно
Доступные опции:
connect,
renew
access
enum<string>
обязательно
Доступные опции:
one_time,
ongoing
status
enum<string>
обязательно

Состояние ссылки. completed, cancelled, expired и failed являются конечными.

Доступные опции:
created,
opened,
connecting,
completed,
cancelled,
expired,
failed
url
string<uri> | null
обязательно

Размещённая страница верификации, на которую нужно направить пользователя. Возвращается только при создании ссылки; при последующих чтениях равна null, потому что токен не сохраняется.

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

Токен для встроенного Bank Link от Didit, который пока не предоставляется: откройте url сегодня. Возвращается только при создании ссылки; при последующих чтениях значение null. Имеет одно назначение и короткий срок жизни. Не содержит персональных данных. Никогда не записывайте его в журнал.

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

Когда перестаёт работать неиспользованная ссылка.

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

Подключение, которое создала или продлила эта ссылка, когда status принимает значение completed.

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

Результат проверки владения по этой ссылке, если запрошено ownership.compare со значением, отличным от none.

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

true, когда ссылка завершилась как продление существующего подключения, потому что человек уже делится именно этими счетами (duplicates: reuse). Повторное списание не производится.

error
object | null
обязательно

Почему ссылка не сработала, когда status равен failed. Иначе null.

quote
object
обязательно

Стоимость ссылки, зафиксированная при её создании. Списывается стоимость из котировки. Чтения не тарифицируются.

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

Ваш референс из запроса.

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