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

События

Каждое событие также содержит общие поля event_id, webhook_type, timestamp, created_at, application_id и environment. Поля событий bank.link.* находятся в data; поля событий подключения, данных и синхронизации находятся на верхнем уровне. ended_by принимает значения end_user, bank, customer или unknown. Точная схема каждого события приведена в Справочнике API.

Пример

Как использовать события

  • Новые данные. bank.data.updated является только сигналом: данные в нём не передаются. Вызовите ленту изменений, передав сохранённый курсор. Событие bank.sync.completed стоит использовать, только если вы хотите видеть каждую синхронизацию, включая те, которые ничего не изменили.
  • Онбординг. Дождитесь bank.connection.created, прежде чем читать счета, и bank.connection.history_complete, прежде чем полагаться на полную историю.
  • Согласие. По событию bank.connection.consent_expiring попросите пользователя продлить согласие. По событию bank.connection.renewal_required данные по-прежнему доступны для чтения, но больше не синхронизируются.
  • Остановка. По событию bank.connection.revoked остановите собственную ленту для этого подключения и решите, нужно ли удалить сохранённые данные.
  • Дубликаты. Обрабатывайте каждое событие идемпотентно: используйте id события как ключ и учитывайте, что одно и то же событие иногда приходит дважды.
  • Не доверяйте браузеру. Подтверждайте ссылку с помощью события bank.link.completed или через GET /v3/bank/links/{id}/, а не по идентификатору ссылки, отправленному страницей.

Следующие шаги

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