Непрерывный банковский фид ежедневно передает продукту для бухгалтерского учета или ведения бухгалтерии балансы и транзакции по банковским счетам каждого клиента, без повторного входа клиента в систему.
С 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.
См. цены.
Чек-лист
Последнее изменение 22 ноября 2026 г.