Перейти к основному содержанию
POST
curl
Эндпоинт Didit «Отозвать подключение к банку» закрывает доступ к банку, и запросы данных из банка прекращаются в момент вашего вызова. Отзыв ничего не удаляет: для этого используйте удалить. Статус согласия сначала становится revocation_pending, а затем revoked, когда банк подтверждает отзыв.

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения берётся в разделе Developers -> API keys в Business Console. Основной ключ имеет полный доступ. Именованный ключ можно ограничить: доступ для каждого ресурса (нет доступа, только чтение или запись), ограничение некоторыми сценариями или одобренными сессиями, список IP-адресов и дата истечения срока. Ответ 401 означает, что ключ неверный, отозван или истёк. Ответ 403 означает, что ключ не передан, у ключа нет доступа к этому ресурсу или действию либо запрос пришёл с адреса вне его списка IP. Ответ 404 на маршруте сессии означает, что сессия находится вне сценариев или статусов, доступных ключу. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без права записи в сессии получает ссылки и токены сессий как null. См. https://docs.didit.me/console/api-keys.

Заголовки

Idempotency-Key
string

Необязательный ключ для безопасных повторных запросов, который вы выбираете для одной операции, до 255 символов (подойдёт UUID). Запрос, повторённый с тем же ключом, endpoint, параметрами запроса и телом, получает первый ответ с тем же статусом и тем же телом и не выполняется и не тарифицируется повторно. Тот же ключ с другим endpoint, параметрами запроса или телом возвращает 409 idempotency_key_reused, а пока первый запрос ещё выполняется, 409 idempotency_key_in_progress с Retry-After. Неудачный запрос (любой 4xx или 5xx) не сохраняется, поэтому его можно отправить повторно с тем же ключом. Ключи принадлежат вашему приложению, независимо от того, вызываете ли вы API с API-ключом или с токеном доступа. См. Повторные попытки и идемпотентность.

Required string length: 1 - 255

Параметры пути

id
string<uuid>
обязательно

Идентификатор подключения.

Ответ

Подключение со статусом отзыва.

Разрешение пользователя вашему приложению на чтение данных одного банка. При продлении сохраняются идентификатор подключения и идентификаторы всех счетов. У удалённого подключения в ответе присутствуют только id, status, status_reason, created_at и erasure, а все остальные поля отсутствуют: данные о банке, пользователе и счетах в нём не остаются.

id
string<uuid>
обязательно

Идентификатор подключения.

status
enum<string>
обязательно

pending: выполняется первая синхронизация. active: согласие действует. renewal_required: согласие закончилось или банк требует, чтобы пользователь снова вошел; данные доступны для чтения в состоянии последней синхронизации, плата не взимается. paused: баланс слишком низкий для месячного списания. revoked: доступ остановлен пользователем, банком или вами. deleted: остаются только id, status, status_reason, created_at и erasure. failed: первая синхронизация так и не завершилась успешно.

Доступные опции:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
status_reason
enum<string> | null
обязательно

Почему подключение находится в этом статусе. paused_by_customer зарезервирован. Для подключения со статусом deleted: deleted_by_customer, consent_lapsed, retention_elapsed или application_deleted.

Доступные опции:
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,
first_sync_failed,
deleted_by_customer,
retention_elapsed,
application_deleted,
null
erasure
object | null
обязательно

Задаётся после delete_connection; иначе null.

created_at
string<date-time>
обязательно
environment
enum<string>
Доступные опции:
live,
sandbox
access
enum<string>
Доступные опции:
one_time,
ongoing
institution
object

Банк, для которого создано подключение или ссылка.

segment
enum<string> | null
Доступные опции:
personal,
business,
null
data
enum<string>[]

Области доступа, которые принял пользователь.

Доступные опции:
accounts,
balances,
transactions

Согласие пользователя на это подключение.

sync
object

Состояние синхронизации подключения.

accounts
object[]

Сводка по каждому счёту в подключении. Чтобы прочитать счёт целиком, используйте get_account.

ownership
object

Необязательное сравнение владельца счёта с физическим лицом или компанией.

end_user
object
manage_url
string<uri> | null

Страница доступа пользователя. Значение null, пока страница доступа недоступна.

billing
object

Сколько стоит это подключение. В песочнице оплата никогда не взимается.

possible_duplicate_of
string<uuid> | null

Задаётся, когда это подключение может дублировать другое активное, но ни один end_user.reference не позволил однозначно установить совпадение.

vendor_data
string | null
updated_at
string<date-time>
Последнее изменение 22 ноября 2026 г.