404, пока не объявлен доступ в продакшн.
Одноразовый и постоянный доступ
Постоянный доступ работает только в тех банках, где он разрешён.
Уточнить это можно с помощью endpoint учреждений или на странице покрытия.
Если банк не может сохранять доступ открытым, пользователю сообщается, что банк не разрешает постоянный доступ, и ему нужно выбрать другой банк.
Установите
allow_one_time_fallback: true, чтобы пользователь мог продолжить с одноразовым считыванием данных после подтверждения ограниченного доступа на своём экране: подключение тогда будет one_time.
Статусы
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: что было предоставлено и сколько раз подключение продлевалось.
Продление
Продление сохраняет идентификатор подключения и все идентификаторы счетов, а история продолжается без дубликатов.- Didit отправляет
bank.connection.consent_expiringза 14, 7 и 1 день до окончания срока. - Вызовите
POST /v3/bank/connections/{id}/renew/. Если до окончания согласия остаётся более 30 дней, он возвращает409 renewal_not_needed. Послеconsent.renewable_untilон возвращает409 renewal_window_expired. В остальных случаях он возвращает201со ссылкой на продление.
renewal_required: данные остаются доступными для чтения в том виде, в котором были синхронизированы в последний раз, и плата не взимается. После consent.renewable_until подключение получает статус revoked с status_reason: consent_lapsed, и пользователю нужно подключиться заново.
Полный сценарий см. в разделе Продление банковского согласия.
Прекращение доступа
Прекращение доступа не означает удаление.
Подробно о том, что именно удаляется, читайте в разделе Данные, согласие и удаление.
Удалённое подключение
Удалённое подключение в ответе содержит только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/принимаетstatus,access,institution_id,country,vendor_data,end_user_reference,consent_expires_beforeиcreated_after. - Стоимость подключения можно посмотреть в объекте
billing: единица измерения, цена и уже оплаченный месяц.