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

# Быстрый старт с банковскими данными: подключение тестового банка и чтение транзакций

> От песочницы до счетов, балансов и транзакций Test Bank от Didit: создайте ключ и ссылку, подключите, считайте, синхронизируйте и удалите.

Банковские данные доступны для приложений в песочнице.
Вызовы из боевого приложения возвращают `404`, пока не объявлен доступ к боевой среде. В песочнице плата не взимается.
Это краткое руководство проведёт вас от приложения в песочнице к счетам, балансам и транзакциям Didit Test Bank с помощью готовых запросов, которые можно скопировать и вставить.

> [!NOTE]
>
> Каждый ответ ниже сокращён до важных полей.
> Храните API-ключ на сервере: он никогда не попадает в браузер или приложение.

## Шаг 1: создайте API-ключ с разрешением Bank data

Bank data не входит в полный доступ.
Ключ с полным доступом, в том числе основной секрет приложения, отклоняется при каждом вызове Bank data с ошибкой `403 bank_data_access_denied`.

1. В [Business Console](https://business.didit.me) откройте ваше приложение в песочнице и перейдите в раздел **API keys**.
2. Создайте ключ с настраиваемым доступом и добавьте **Bank data**: **Read** для операций чтения, **Write** для вызовов, которые создают, изменяют или удаляют что-либо.
3. Скопируйте ключ и экспортируйте его:

```bash theme={null}
export DIDIT_API_KEY="your-sandbox-key"
```

Полный список ресурсов см. в разделе [API-ключи](https://docs.didit.me/ru/console/api-keys.md).

## Шаг 2: создайте ссылку

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

```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",
    "data": ["accounts", "balances", "transactions"],
    "history_days": 90,
    "vendor_data": "client-7731"
  }'
```

Поле `country` содержит трёхбуквенный код страны банка пользователя и является необязательным.
Передавайте его, когда знаете страну: тогда пользователь увидит только банки этой страны. Если его не передать, пользователь выбирает среди банков всех стран, с которыми вы можете работать.
Для одноразового доступа передайте `"access": "one_time"` (это значение по умолчанию).

```json theme={null}
{
  "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40",
  "mode": "connect",
  "access": "ongoing",
  "status": "created",
  "url": "https://verify.didit.me/bank/link/...",
  "expires_at": "2026-11-22T13:00:00Z",
  "connection_id": null
}
```

Сохраните `id` ссылки, связав его с пользователем.
`url` и `client_token` возвращаются один раз, при создании ссылки.

## Шаг 3: откройте ссылку и подключите Didit Test Bank

Откройте `url` в браузере или отправьте его пользователю по электронной почте или в чат.
Пользователь видит экран согласия, выбирает **Didit Test Bank**, входит в систему как один из тестовых клиентов и выбирает счета, к которым предоставляет доступ.
На [странице песочницы](https://docs.didit.me/ru/core-technology/bank-verification/sandbox.md) перечислены тестовые клиенты и то, что каждый из них предоставляет.

Чтобы вернуть пользователя на ваш сайт после завершения, см. раздел [Возврат на ваш сайт](https://docs.didit.me/ru/integration/bank-link/return-to-your-site.md).
Если `redirect_url` не задан, пользователь завершает процесс на странице результата Didit, а результат вы узнаёте из webhook или из запроса на чтение данных.

## Step 4: получите webhook-уведомления и подтвердите результат

Подпишите адрес назначения на события `bank.*` в консоли так же, как для любого другого [webhook](https://docs.didit.me/ru/integration/webhooks.md).
Когда конечный пользователь завершает процесс, приходит `bank.link.completed` с `link_id` и `connection_id`. Затем, после того как первая синхронизация сохранит счета, приходит `bank.connection.created`.

Никогда не доверяйте идентификатору ссылки, который передаёт браузер.
Запросите данные ссылки самостоятельно:

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

```json theme={null}
{ "id": "0b9c4f1e-6a2d-4e8b-9f31-7c5d2e1a8b40", "status": "completed", "connection_id": "5e1d2a70-3b4c-4d5e-8f60-71829304a5b6" }
```

Поле `status` принимает значение `completed` или одно из конечных значений: `cancelled`, `expired`, `failed`. Ссылка со статусом `failed` содержит `error.code`. У ссылки со статусом `cancelled` в ответе указано `error: null`.

## Шаг 5: чтение счетов, балансов и транзакций

```bash theme={null}
curl https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/accounts/ -H "x-api-key: $DIDIT_API_KEY"
curl https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/balances/ -H "x-api-key: $DIDIT_API_KEY"
curl "https://verification.didit.me/v3/bank/accounts/$ACCOUNT_ID/transactions/?date_from=2026-01-01" -H "x-api-key: $DIDIT_API_KEY"
```

Суммы передаются в виде десятичных строк, отрицательное значение означает списание средств.
Если есть ещё данные для чтения, страница транзакций содержит `next_page_token`.
См. [Счета, балансы и транзакции](https://docs.didit.me/ru/core-technology/bank-verification/accounts-balances-transactions.md).

## Шаг 6: отслеживание ленты изменений

Лента изменений возвращает только то, что изменилось с момента вашего последнего чтения.
Первое чтение без курсора возвращает полный снимок: каждую транзакцию, имеющуюся у подключения, с пометкой `added` и `reset: true`.
Первая страница может содержать `has_more: true` с `next_page_token`, но без `next_cursor`.
Пока `has_more` равно `true`, продолжайте чтение с помощью `page_token`. Сохраните `next_cursor` последней страницы (той, где `has_more: false`), чтобы использовать его при следующем чтении:

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

`reset: true` означает, что ответ является полным снимком: замените им свою копию, а не добавляйте к ней.
`bank.data.updated` сообщает, когда синхронизация сохранила новые данные.

## Шаг 7: синхронизация сейчас

Постоянное подключение синхронизируется автоматически.
Чтобы считать данные банка прямо сейчас, запросите синхронизацию:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ -H "x-api-key: $DIDIT_API_KEY"
```

Банк разрешает ограниченное количество считываний без участия пользователя в день.
`sync.live_syncs_left_today` и `sync.budgets` в подключении показывают, сколько их осталось и когда счётчик сбрасывается. Вызов сверх лимита возвращает `429 refresh_limit_reached` и время сброса.
См. [Обновление данных банка по запросу](https://docs.didit.me/ru/use-cases/refresh-bank-data-on-demand.md).

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

Прекращение доступа и удаление выполняются разными вызовами.

```bash theme={null}
# Stop access at the bank. The connection keeps its data until you delete it.
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/revoke/ -H "x-api-key: $DIDIT_API_KEY"

# Delete the connection and its data. Irreversible.
curl -X DELETE https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/ -H "x-api-key: $DIDIT_API_KEY"
```

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

## Следующие шаги

* [Подключения](https://docs.didit.me/ru/core-technology/bank-verification/connections.md): разовый и постоянный доступ, согласие и продление.
* [Банковские webhook](https://docs.didit.me/ru/core-technology/bank-verification/webhooks.md)
* [Цены](https://docs.didit.me/ru/getting-started/bank-verification-pricing.md)
* [Справочник API](https://docs.didit.me/ru/standalone-apis/bank-data.md)


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