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

Что нужно

  • API-ключ с разрешением на доступ к банковским данным для вашего приложения в песочнице. См. быстрый старт.
  • Адрес назначения webhook, который принимает события bank.*. См. Webhook для банковских данных.
  • Таблица в вашей базе данных для каждого клиента с идентификатором подключения, курсором ленты изменений и датой окончания согласия.

Шаг 1: создайте ссылку с постоянным доступом

  • access: ongoing сохраняет доступ открытым до окончания согласия. consent_days является запросом: банк сам определяет фактическую дату, которая отображается в подключении.
  • history_from запрашивает историю начиная с указанной даты, например с начала года. Вместо него можно использовать history_days (от 1 до 365), но не оба параметра одновременно. Банк может предоставить меньше данных: каждый счёт сообщает history_coverage.
  • ownership.compare: none пропускает сравнение владельца, поэтому эталонная личность не нужна. Используйте business, чтобы сравнить владельца с компанией, верифицированной в Didit.
  • end_user.reference содержит ваш идентификатор клиента. По нему можно выполнять поиск, и Didit распознает того же клиента, если он снова подключит те же счета.
  • Отправьте клиента на размещённую страницу верификации и верните его в ваш продукт по URL перенаправления.
Сохраните id ссылки вместе с клиентом.

Шаг 2: дождитесь подключения

Когда клиент завершит процесс, приходит bank.link.completed с connection_id. Подтвердите его, так как браузеру доверять нельзя:
Сохраните connection_id и дождитесь bank.connection.created: после этого счета, балансы и последние транзакции доступны для чтения (sync.initial_status равен succeeded или partial). bank.connection.history_complete приходит по завершении догрузки истории. Для каждого счета history_coverage.oldest_booking_date показывает, насколько далеко в прошлое банк действительно передал данные.

Шаг 3: загрузите первую копию

Пустой курсор возвращает все текущие транзакции как added с reset: true. Пройдите по ним постранично и сохраните курсор только в конце:
  • Первое чтение является полным снимком: оно возвращает каждую транзакцию, доступную подключению на момент начала чтения, ровно один раз как added в её текущем состоянии, даже если во время постраничного чтения выполняется синхронизация.
  • Изменения, внесённые во время постраничного чтения, приходят в следующем чтении из next_cursor: уже полученная транзакция придёт снова как modified, а новая как added.
  • Сохраняйте next_cursor только после ответа с has_more: false.
  • Если постраничная загрузка прервалась на середине, начните заново с сохранённого курсора.
  • Читайте балансы через GET /v3/bank/accounts/{account_id}/balances/.

Шаг 4: поддерживайте данные в актуальном состоянии при каждом webhook

Didit синхронизирует каждое активное постоянное подключение автоматически, от одного до четырёх раз в день, в зависимости от банка (sync.frequency_per_day). Когда синхронизация сохраняет изменения, bank.data.updated приходит с connection_id, account_ids и количеством записей. Запросите ленту изменений, передав сохранённый курсор:
  • added: новые транзакции, включая транзакции в обработке.
  • modified: транзакции, которые изменились, в их текущем состоянии. Применяйте каждую как upsert по id: если у вас уже есть такая транзакция, она обновляется, а если её пока нет, она добавляется.
  • removed содержит reason. Игнорируйте id, которого у вас нет. Когда транзакция в обработке проводится, она попадает в removed с pending_booked, а проведённая транзакция приходит в added.
Используйте id транзакции как ключ: он остаётся тем же при всех чтениях, синхронизациях и продлениях. Проверьте identity_quality: при значении derived корректировка банка может прийти как одна запись в removed и одна в added. Запросы на чтение не тарифицируются, но данные меняются только при запуске синхронизации, поэтому достаточно одного чтения на каждый webhook. Чтобы получить данные раньше, используйте Sync Now: Обновление данных банка по запросу.

Шаг 5: обработка сброса

Курсор, который старше окна воспроизведения, возвращает 410 cursor_expired с bootstrap: true. Журнал изменений можно воспроизводить в течение 90 дней, поэтому для ежедневного задания это случается редко. Начните заново с пустого курсора и замените свою копию результатом, а не добавляйте результат к ней. Каждое чтение из пустого курсора содержит reset: true, поэтому один и тот же путь выполнения обрабатывает и новое подключение, и истёкший курсор.

Шаг 6: следите за окончанием срока действия согласия

У согласия есть дата окончания: consent.expires_at. Didit отправляет bank.connection.consent_expiring за 14, 7 и 1 день до этой даты. Вызывайте renew_connection, когда хотите продлить согласие: до тех пор, пока до окончания не останется 30 дней, он возвращает 409 renewal_not_needed. Страница, на которой клиент завершает продление, пока недоступна. Если клиент позволит согласию истечь, подключение перейдёт в статус renewal_required: вы по-прежнему можете читать синхронизированные данные. Подробности см. в разделе Продление банковского согласия.

Шаг 7: остановка доступа и удаление

  • Клиент покидает ваш продукт: вызовите revoke_connection, чтобы сразу прекратить чтение, или delete_connection, чтобы прекратить доступ и удалить сохранённые данные.
  • Клиент прекращает передачу данных в банке: bank.connection.revoked приходит с ended_by. Остановите передачу данных для этого подключения.

Цена

Постоянный доступ оплачивается за активное подключение в месяц. В цену входят все счета в подключении, балансы, транзакции, до 365 дней истории там, где банк её предоставляет, автоматические синхронизации, синхронизации в реальном времени в пределах лимитов банка, продления, webhook и все запросы на чтение. Ссылка, по которой никто не завершил подключение, бесплатна, как и подключения в статусах renewal_required, paused и revoked. См. цены.

Чек-лист

  • Одно подключение на клиента и банк, хранится вместе с курсором и датой окончания согласия.
  • Обработчик webhook идемпотентен и использует в качестве ключа id события.
  • reset: true заменяет вашу копию, но никогда не дополняет её.
  • Событие removed обрабатывается, с указанием причины.
  • Напоминания о согласии связаны с вашим собственным уведомлением клиенту.
  • bank.connection.revoked останавливает поток данных.
  • Тариф песочницы в Песочница проходит проверку.
Последнее изменение 22 ноября 2026 г.