> ## 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.

# Банковская лента для бухгалтерии: балансы и транзакции

> Ежедневная лента балансов и транзакций для каждого клиента Didit: постоянная связь, webhook, курсор изменений, сброс, завершение согласия и остановка.

Непрерывный банковский фид ежедневно передает продукту для бухгалтерского учета или ведения бухгалтерии балансы и транзакции по банковским счетам каждого клиента, без повторного входа клиента в систему.

С Didit вы создаете ссылку с постоянным доступом, получаете webhook-уведомления при поступлении новых данных, читаете только изменения с помощью курсора, отслеживаете, когда заканчивается согласие, и останавливаете или удаляете подключение, когда клиент уходит.

Это руководство проведет вас от нуля до ежедневного фида для одного клиента.
Один и тот же код работает для каждого клиента: по одному подключению на каждого клиента и банк.

## Что нужно

* API-ключ с разрешением на доступ к банковским данным для вашего приложения в песочнице. См. [быстрый старт](https://docs.didit.me/ru/core-technology/bank-verification/quickstart.md#шаг-1-создайте-api-ключ-с-разрешением-bank-data).
* Адрес назначения webhook, который принимает события `bank.*`. См. [Webhook для банковских данных](https://docs.didit.me/ru/core-technology/bank-verification/webhooks.md).
* Таблица в вашей базе данных для каждого клиента с идентификатором подключения, курсором ленты изменений и датой окончания согласия.

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

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/links/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{
    "access": "ongoing",
    "country": "ESP",
    "segment": "business",
    "data": ["accounts", "balances", "transactions"],
    "history_from": "2026-01-01",
    "consent_days": 180,
    "ownership": { "compare": "none" },
    "end_user": { "reference": "client-7731", "email": "ana@example.com" },
    "redirect_url": "http://localhost:3000/bank/return",
    "vendor_data": "client-7731"
  }'
```

* `access: ongoing` сохраняет доступ открытым до окончания согласия. `consent_days` является запросом: банк сам определяет фактическую дату, которая отображается в подключении.
* `history_from` запрашивает историю начиная с указанной даты, например с начала года. Вместо него можно использовать `history_days` (от 1 до 365), но не оба параметра одновременно. Банк может предоставить меньше данных: каждый счёт сообщает `history_coverage`.
* `ownership.compare: none` пропускает сравнение владельца, поэтому эталонная личность не нужна. Используйте `business`, чтобы сравнить владельца с компанией, верифицированной в Didit.
* `end_user.reference` содержит ваш идентификатор клиента. По нему можно выполнять поиск, и Didit распознает того же клиента, если он снова подключит те же счета.
* Отправьте клиента на [размещённую страницу верификации](https://docs.didit.me/ru/integration/bank-link/hosted-link.md) и верните его в ваш продукт по [URL перенаправления](https://docs.didit.me/ru/integration/bank-link/return-to-your-site.md).

Сохраните `id` ссылки вместе с клиентом.

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

Когда клиент завершит процесс, приходит `bank.link.completed` с `connection_id`.
Подтвердите его, так как браузеру доверять нельзя:

```bash theme={null}
curl https://verification.didit.me/v3/bank/links/$LINK_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

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

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

Пустой курсор возвращает все текущие транзакции как `added` с `reset: true`.
Пройдите по ним постранично и сохраните курсор только в конце:

```bash theme={null}
curl "https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/transactions/sync/?limit=500" \
  -H "x-api-key: $DIDIT_API_KEY"
```

```python theme={null}
cursor, page_token = stored_cursor or "", None
while True:
    params = {"limit": 500, "page_token": page_token} if page_token else {"cursor": cursor, "limit": 500}
    page = get(f"/v3/bank/connections/{connection_id}/transactions/sync/", params)
    if page["reset"] and not page_token:
        wipe_local_copy(connection_id)       # replace, never append
    apply(page["added"], page["modified"], page["removed"])
    if not page["has_more"]:
        store_cursor(connection_id, page["next_cursor"])
        break
    page_token = page["next_page_token"]
```

* Первое чтение является полным снимком: оно возвращает каждую транзакцию, доступную подключению на момент начала чтения, ровно один раз как `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: [Обновление данных банка по запросу](https://docs.didit.me/ru/use-cases/refresh-bank-data-on-demand.md).

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

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

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

У согласия есть дата окончания: `consent.expires_at`.
Didit отправляет `bank.connection.consent_expiring` за 14, 7 и 1 день до этой даты.

Вызывайте [`renew_connection`](https://docs.didit.me/ru/standalone-apis/bank-connection-renew), когда хотите продлить согласие: до тех пор, пока до окончания не останется 30 дней, он возвращает `409 renewal_not_needed`.
Страница, на которой клиент завершает продление, пока недоступна.

Если клиент позволит согласию истечь, подключение перейдёт в статус `renewal_required`: вы по-прежнему можете читать синхронизированные данные.
Подробности см. в разделе [Продление банковского согласия](https://docs.didit.me/ru/use-cases/renew-bank-consent.md).

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

* Клиент покидает ваш продукт: вызовите [`revoke_connection`](https://docs.didit.me/ru/standalone-apis/bank-connection-revoke), чтобы сразу прекратить чтение, или [`delete_connection`](https://docs.didit.me/ru/standalone-apis/bank-connection-delete), чтобы прекратить доступ и удалить сохранённые данные.
* Клиент прекращает передачу данных в банке: `bank.connection.revoked` приходит с `ended_by`. Остановите передачу данных для этого подключения.

## Цена

Постоянный доступ оплачивается за активное подключение в месяц.
В цену входят все счета в подключении, балансы, транзакции, до 365 дней истории там, где банк её предоставляет, автоматические синхронизации, синхронизации в реальном времени в пределах лимитов банка, продления, webhook и все запросы на чтение.
Ссылка, по которой никто не завершил подключение, бесплатна, как и подключения в статусах `renewal_required`, `paused` и `revoked`.
См. [цены](https://docs.didit.me/ru/getting-started/bank-verification-pricing.md#банковские-данные-и-постоянный-доступ).

## Чек-лист

* [ ] Одно подключение на клиента и банк, хранится вместе с курсором и датой окончания согласия.
* [ ] Обработчик webhook идемпотентен и использует в качестве ключа id события.
* [ ] `reset: true` заменяет вашу копию, но никогда не дополняет её.
* [ ] Событие `removed` обрабатывается, с указанием причины.
* [ ] Напоминания о согласии связаны с вашим собственным уведомлением клиенту.
* [ ] `bank.connection.revoked` останавливает поток данных.
* [ ] Тариф песочницы в [Песочница](https://docs.didit.me/ru/core-technology/bank-verification/sandbox.md#хороший-план-тестирования) проходит проверку.


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