Перейти к основному содержанию
Банковское подключение Didit: это разрешение, которое даёт вашему приложению право читать данные одного банка для конкретного пользователя или компании. В подключении хранятся даты согласия, состояние синхронизации и счета. Завершённый Bank Link создаёт подключение, которое действует, пока это позволяют банк и пользователь или компания. Банковские данные доступны для приложений в песочнице. Вызовы из продакшн-приложения возвращают 404, пока не объявлен доступ в продакшн.

Одноразовый и постоянный доступ

Постоянный доступ работает только в тех банках, где он разрешён. Уточнить это можно с помощью endpoint учреждений или на странице покрытия. Если банк не может сохранять доступ открытым, пользователю сообщается, что банк не разрешает постоянный доступ, и ему нужно выбрать другой банк. Установите allow_one_time_fallback: true, чтобы пользователь мог продолжить с одноразовым считыванием данных после подтверждения ограниченного доступа на своём экране: подключение тогда будет one_time.

Статусы

status_reason принимает одно из следующих значений: collection_complete, consent_expired, consent_lapsed, bank_requires_sign_in, revoked_by_end_user, revoked_by_bank, revoked_by_customer, insufficient_balance, paused_by_customer (зарезервировано, ни один endpoint сейчас его не устанавливает) и first_sync_failed.

Согласие

Банк определяет срок действия согласия, но не дольше consent_days, который вы запросили. Реальные даты каждого подключения указаны в consent:
  • expires_at и renew_by: окончание согласия. Продлите подключение до этого момента, чтобы не было перерыва.
  • renewable_until: последний момент, до которого то же подключение можно восстановить после окончания согласия.
  • renewed_count, version, scopes_granted и accounts_granted: что было предоставлено и сколько раз подключение продлевалось.
Срок согласия определяется тем, сколько времени разрешает банк. Актуальное значение смотрите в каждом подключении, а значение для каждого банка указано в данных об учреждении.

Продление

Продление сохраняет идентификатор подключения и все идентификаторы счетов, а история продолжается без дубликатов.
  1. Didit отправляет bank.connection.consent_expiring за 14, 7 и 1 день до окончания срока.
  2. Вызовите POST /v3/bank/connections/{id}/renew/. Если до окончания согласия остаётся более 30 дней, он возвращает 409 renewal_not_needed. После consent.renewable_until он возвращает 409 renewal_window_expired. В остальных случаях он возвращает 201 со ссылкой на продление.
Страница, на которой пользователь завершает продление, пока недоступна, поэтому сегодня не отправляйте людей по ссылке на продление. Если пользователь не продлевает согласие, подключение переходит в статус renewal_required: данные остаются доступными для чтения в том виде, в котором были синхронизированы в последний раз, и плата не взимается. После consent.renewable_until подключение получает статус revoked с status_reason: consent_lapsed, и пользователю нужно подключиться заново. Полный сценарий см. в разделе Продление банковского согласия.

Прекращение доступа

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

Удалённое подключение

Удалённое подключение в ответе содержит только id, status (deleted), status_reason, created_at и erasure. status_reason принимает одно из значений: deleted_by_customer, consent_lapsed, retention_elapsed или application_deleted. Все остальные поля отсутствуют.

Дубликаты

Новая ссылка, которая ведёт ровно к тем счетам, которыми вы уже делитесь с тем же end_user.reference в том же банке, завершается как продление этого подключения (reused: true), и плата не списывается повторно. Любое другое пересечение приводит к тому, что ссылка получает статус failed с кодом duplicate_conflict и полем conflicts_with, до того как что-либо будет сохранено или списано. Продлите существующее подключение или создайте ссылку заново с "duplicates": "allow", если нужно независимое второе подключение.

Управление подключениями ваших клиентов

  • Список с фильтрами: GET /v3/bank/connections/ принимает status, access, institution_id, country, vendor_data, end_user_reference, consent_expires_before и created_after.
  • Стоимость подключения можно посмотреть в объекте billing: единица измерения, цена и уже оплаченный месяц.
Последнее изменение 22 ноября 2026 г.