> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks банковской верификации: события bank.link, bank.connection, bank.data

> События webhook bank.link, bank.connection, bank.data и bank.sync в Didit: когда отправляются, что содержат и как запускать ежедневное чтение.

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

> [!NOTE]
>
> Банковские webhook-события отправляются для приложений в продакшн-среде и в песочнице.
> Выбирайте события для каждого адреса назначения webhook с помощью фильтра событий этого адреса, как и для других событий.
> Структуру сообщения, заголовки подписи и повторные попытки см. в разделе [Webhooks](https://docs.didit.me/ru/integration/webhooks.md).

## События

| Событие | Когда | Поля |
| - | - | - |
| `bank.link.completed` | Пользователь подключил банк. | `data.link_id`, `data.status`, `data.connection_id`, `data.check_id`, `data.error_code` (всегда `null`) |
| `bank.link.cancelled` | Пользователь отменил процесс. | `data.link_id`, `data.status` |
| `bank.link.expired` | Ссылка истекла до завершения процесса. | `data.link_id`, `data.status` |
| `bank.link.failed` | Процесс по ссылке завершился с ошибкой. | `data.link_id`, `data.status`, `data.error_code` |
| `bank.connection.created` | Первая синхронизация завершена, счета доступны для чтения. | `connection_id`, `initial_status` |
| `bank.connection.history_complete` | Загрузка истории завершилась по любой причине. | `connection_id`, `status` |
| `bank.connection.updated` | Изменились статус, согласие или состояние синхронизации. | `connection_id`, `status`, `revocation_status` |
| `bank.connection.consent_expiring` | За 14, 7 и 1 день до окончания согласия. | `connection_id`, `days_left`, `consent_expires_at`, `renew_by` |
| `bank.connection.renewal_required` | Согласие истекло или банк просит пользователя войти повторно. | `connection_id`, `status`, `reason`, `renew_by`, `renewable_until` |
| `bank.connection.renewed` | Процесс по ссылке для продления завершён. | `connection_id`, `status`, `consent_version`, `link_id`, `consent_expires_at` |
| `bank.connection.revoked` | Доступ прекращён. | `connection_id`, `status`, `ended_by`, `status_reason`, `ended_at`, `retain_until` |
| `bank.connection.deleted` | Подключение и его данные удалены. | `connection_id`, `status`, `erasure_status`, `reason`, `erased_at` |
| `bank.data.updated` | Синхронизация сохранила изменения. | `connection_id`, `sync_id`, `trigger`, `accounts` (идентификаторы с указанием количества), `balances_changed` |
| `bank.sync.completed` | Каждая синхронизация завершена. | `connection_id`, `sync_id`, `trigger`, `outcome`, `changed` |
| `bank.sync.failed` | Синхронизация продолжает завершаться с ошибкой. | `connection_id`, `sync_id`, `error_code`, `failing_since` |
| `bank.sync.recovered` | Синхронизация, которая завершалась с ошибкой, снова работает. | `connection_id`, `sync_id` |

Каждое событие также содержит общие поля `event_id`, `webhook_type`, `timestamp`, `created_at`, `application_id` и `environment`.
Поля событий `bank.link.*` находятся в `data`; поля событий подключения, данных и синхронизации находятся на верхнем уровне.
`ended_by` принимает значения `end_user`, `bank`, `customer` или `unknown`.
Точная схема каждого события приведена в [Справочнике API](https://docs.didit.me/ru/standalone-apis/bank-data.md).

## Пример

```json theme={null}
{
  "event_id": "7c1e0a52-93d4-4a6b-8f21-0d5b9e3a64c7",
  "webhook_type": "bank.sync.completed",
  "timestamp": 1763804640,
  "created_at": 1763804640,
  "application_id": "b3e1f0a2-5d64-4c8e-9a17-2f6d0c8b7e41",
  "environment": "sandbox",
  "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6",
  "sync_id": "c2b8d4f6-9a13-4e07-85bc-3d6e1f0a7b92",
  "trigger": "scheduled",
  "outcome": "succeeded",
  "changed": true
}
```

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

* **Новые данные.** `bank.data.updated` является только сигналом: данные в нём не передаются. Вызовите [ленту изменений](https://docs.didit.me/ru/standalone-apis/bank-transactions-sync.md), передав сохранённый курсор. Событие `bank.sync.completed` стоит использовать, только если вы хотите видеть каждую синхронизацию, включая те, которые ничего не изменили.
* **Онбординг.** Дождитесь `bank.connection.created`, прежде чем читать счета, и `bank.connection.history_complete`, прежде чем полагаться на полную историю.
* **Согласие.** По событию `bank.connection.consent_expiring` попросите пользователя продлить согласие. По событию `bank.connection.renewal_required` данные по-прежнему доступны для чтения, но больше не синхронизируются.
* **Остановка.** По событию `bank.connection.revoked` остановите собственную ленту для этого подключения и решите, нужно ли [удалить](https://docs.didit.me/ru/standalone-apis/bank-connection-delete.md) сохранённые данные.
* **Дубликаты.** Обрабатывайте каждое событие идемпотентно: используйте id события как ключ и учитывайте, что одно и то же событие иногда приходит дважды.
* **Не доверяйте браузеру.** Подтверждайте ссылку с помощью события `bank.link.completed` или через `GET /v3/bank/links/{id}/`, а не по идентификатору ссылки, отправленному страницей.

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

* [Непрерывная банковская передача данных для бухгалтерии](https://docs.didit.me/ru/use-cases/bank-data-for-accounting.md)
* [Песочница](https://docs.didit.me/ru/core-technology/bank-verification/sandbox.md): тестовый банк Didit отправляет эти события.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.