Банковские 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}/, а не по идентификатору ссылки, отправленному страницей.
Следующие шаги
- Непрерывная банковская передача данных для бухгалтерии
- Песочница: тестовый банк Didit отправляет эти события.