> ## 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. Узнайте статусы, как прекращается согласие, как его продлить и как отозвать доступ.

Банковское подключение Didit: это разрешение, которое даёт вашему приложению право читать данные одного банка для конкретного пользователя или компании. В подключении хранятся даты согласия, состояние синхронизации и счета.
Завершённый [Bank Link](https://docs.didit.me/ru/core-technology/bank-verification/bank-link.md) создаёт подключение, которое действует, пока это позволяют банк и пользователь или компания.

Банковские данные доступны для приложений в песочнице. Вызовы из продакшн-приложения возвращают `404`, пока не объявлен доступ в продакшн.

## Одноразовый и постоянный доступ

| | Одноразовый | Постоянный |
| - | - | - |
| `access` | `one_time` (по умолчанию) | `ongoing` |
| Что происходит | Данные считываются один раз, когда пользователь подключается, после чего доступ прекращается (`status_reason: collection_complete`). | Доступ остаётся открытым до окончания согласия или до тех пор, пока его не остановят. |
| Данные после этого | Доступны для чтения через те же endpoint'ы. | Синхронизируются автоматически от одного до четырёх раз в день в зависимости от банка, а также по запросу в режиме реального времени. |
| Биллинг | За проверку, см. [цены](https://docs.didit.me/ru/getting-started/bank-verification-pricing.md) | За каждое активное подключение в месяц, см. [цены](https://docs.didit.me/ru/getting-started/bank-verification-pricing.md) |

Постоянный доступ работает только в тех банках, где он разрешён.
Уточнить это можно с помощью [endpoint учреждений](https://docs.didit.me/ru/standalone-apis/bank-institutions-list.md) или на [странице покрытия](https://docs.didit.me/ru/core-technology/bank-verification/coverage.md).
Если банк не может сохранять доступ открытым, пользователю сообщается, что банк не разрешает постоянный доступ, и ему нужно выбрать другой банк.
Установите `allow_one_time_fallback: true`, чтобы пользователь мог продолжить с одноразовым считыванием данных после подтверждения ограниченного доступа на своём экране: подключение тогда будет `one_time`.

## Статусы

| `status` | Значение | Данные доступны | Синхронизация | Тарификация |
| - | - | - | - | - |
| `pending` | Подключение завершено, выполняется первая синхронизация. | Пока нет | Выполняется | Нет |
| `active` | Согласие действительно, синхронизация работает штатно или выполняется повторная попытка. | Да | Да | Да |
| `renewal_required` | Согласие завершилось или банк просит конечного пользователя войти снова. `status_reason` указывает, какая именно. | По последней синхронизации | Нет | Нет |
| `paused` | Баланса недостаточно для покрытия расходов за месяц. | По последней синхронизации | Нет | Нет |
| `revoked` | Доступ был прекращён конечным пользователем, банком или вами. `consent.ended_by` указывает, кто именно. | До `consent.retain_until` | Нет | Нет |
| `deleted` | Подключение и его данные удалены. | Нет | Нет | Нет |
| `failed` | Первая синхронизация так и не завершилась успешно. | Нет | Нет | Нет |

`status_reason` принимает одно из следующих значений: `collection_complete`, `consent_expired`, `consent_lapsed`, `bank_requires_sign_in`, `revoked_by_end_user`, `revoked_by_bank`, `revoked_by_customer`, `insufficient_balance`, `paused_by_customer` (зарезервировано, ни один endpoint сейчас его не устанавливает) и `first_sync_failed`.

## Согласие

Банк определяет срок действия согласия, но не дольше `consent_days`, который вы запросили.
Реальные даты каждого подключения указаны в `consent`:

* `expires_at` и `renew_by`: окончание согласия. Продлите подключение до этого момента, чтобы не было перерыва.
* `renewable_until`: последний момент, до которого то же подключение можно восстановить после окончания согласия.
* `renewed_count`, `version`, `scopes_granted` и `accounts_granted`: что было предоставлено и сколько раз подключение продлевалось.

Срок согласия определяется тем, сколько времени разрешает банк.
Актуальное значение смотрите в каждом подключении, а значение для каждого банка указано в данных об учреждении.

## Продление

Продление сохраняет идентификатор подключения и все идентификаторы счетов, а история продолжается без дубликатов.

1. Didit отправляет `bank.connection.consent_expiring` за 14, 7 и 1 день до окончания срока.
2. Вызовите [`POST /v3/bank/connections/{id}/renew/`](https://docs.didit.me/ru/standalone-apis/bank-connection-renew). Если до окончания согласия остаётся более 30 дней, он возвращает `409 renewal_not_needed`. После `consent.renewable_until` он возвращает `409 renewal_window_expired`. В остальных случаях он возвращает `201` со ссылкой на продление.

Страница, на которой пользователь завершает продление, пока недоступна, поэтому сегодня не отправляйте людей по ссылке на продление.

Если пользователь не продлевает согласие, подключение переходит в статус `renewal_required`: данные остаются доступными для чтения в том виде, в котором были синхронизированы в последний раз, и плата не взимается. После `consent.renewable_until` подключение получает статус `revoked` с `status_reason: consent_lapsed`, и пользователю нужно подключиться заново.

Полный сценарий см. в разделе [Продление банковского согласия](https://docs.didit.me/ru/use-cases/renew-bank-consent.md).

## Прекращение доступа

| Кто | Как | Что происходит |
| - | - | - |
| Конечный пользователь | **Прекратить передачу данных** в своём банке | `bank.connection.revoked` с `ended_by: end_user` или `bank` |
| Вы | [`revoke_connection`](https://docs.didit.me/ru/standalone-apis/bank-connection-revoke) | Получение данных банком немедленно прекращается. Статус согласия становится `revocation_pending`, а затем `revoked`, когда банк подтверждает отзыв. Данные, которые уже были считаны, остаются доступными, пока вы не удалите подключение или не истечёт срок `consent.retain_until`. |
| Вы | [`delete_connection`](https://docs.didit.me/ru/standalone-apis/bank-connection-delete) | Прекращает доступ и удаляет подключение, а также его счета, балансы и транзакции. Необратимо. |

Прекращение доступа не означает удаление.
Подробно о том, что именно удаляется, читайте в разделе [Данные, согласие и удаление](https://docs.didit.me/ru/core-technology/bank-verification/data-consent-and-deletion.md).

## Удалённое подключение

Удалённое подключение в ответе содержит только `id`, `status` (`deleted`), `status_reason`, `created_at` и `erasure`.
`status_reason` принимает одно из значений: `deleted_by_customer`, `consent_lapsed`, `retention_elapsed` или `application_deleted`.
Все остальные поля отсутствуют.

## Дубликаты

Новая ссылка, которая ведёт ровно к тем счетам, которыми вы уже делитесь с тем же `end_user.reference` в том же банке, завершается как продление этого подключения (`reused: true`), и плата не списывается повторно.
Любое другое пересечение приводит к тому, что ссылка получает статус `failed` с кодом `duplicate_conflict` и полем `conflicts_with`, до того как что-либо будет сохранено или списано.
Продлите существующее подключение или создайте ссылку заново с `"duplicates": "allow"`, если нужно независимое второе подключение.

## Управление подключениями ваших клиентов

* Список с фильтрами: [`GET /v3/bank/connections/`](https://docs.didit.me/ru/standalone-apis/bank-connections-list) принимает `status`, `access`, `institution_id`, `country`, `vendor_data`, `end_user_reference`, `consent_expires_before` и `created_after`.
* Стоимость подключения можно посмотреть в объекте `billing`: единица измерения, цена и уже оплаченный месяц.


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