# Банк по API

Инструкция БЭФИ · раздел «Деньги и банк» · актуально на: 7 ноября 2026

Подключите выписки Т-Банка, Точки или Модульбанка, проверьте связь и сверьте первую загрузку.

Подготовьте: доступ в интернет-банк и счёт в БЭФИ с правильными номером и БИК (Справочники → Мои счета).

## Шаг 1. Токен — только на чтение

Где в программе: Интернет-банк → Интеграции / API

1. В интернет-банке выпустите токен (ключ доступа) для БЭФИ.
2. Права — только на чтение счетов и выписок. Права на платежи не ставьте.
3. Скопируйте токен сразу — банк показывает его один раз.

Подробно: Почему это безопасно. Это подключение используется для чтения выписок. Подготовка платёжных поручений настраивается отдельно — см. «Платежи на подпись». В программе токен хранится зашифрованным. Отозвали токен в банке — доступ закрыт мгновенно. Подключать банк может владелец или пользователь с правом «Выписки по API».

## Шаг 2. Где токен в вашем банке

Где в программе: Т-Банк · Точка · Модульбанк

1. Т-Банк: Т-Бизнес → «Интеграции» → T-API → «Выпустить токен»; права «Счета» и «Выписки».
2. Точка: «Сервисы → Интеграции и API → JWT-ключи». Если доступны разрешения, выберите ReadAccountsBasic и ReadStatements. Если выбора нет, ключ получает права выпустившего его сотрудника: для выписок используйте сотрудника с правом только на просмотр.
3. Модульбанк: «Настройки» → «Интеграции» (API) → создать токен; права account-info и operation-history.

Подробно: Особенности банков. Т-Банк отдаёт только проведённые операции (холды по картам не грузятся), данные — с июня 2023 года. Точка готовит выписку несколько секунд — БЭФИ ждёт до минуты; у счёта обязателен БИК. Модульбанк: один токен видит все счета компании — БЭФИ сама находит нужный по номеру. Другие банки — выписка на почту или файлом.

## Шаг 3. Вставьте токен в БЭФИ

Где в программе: Справочники → Мои счета → ваш счёт

1. Откройте счёт и найдите блок «Выписки по API банка».
2. «Подключение» — выберите банк, вставьте токен → «Сохранить подключение».

Подробно: Номер и БИК счёта в БЭФИ должны совпадать с банком: по ним программа находит счёт среди счетов токена. Блок «Выписки по API банка» есть только у банковских счетов и только у тех, кому разрешено подключать API.

## Шаг 4. Проверьте подключение

Где в программе: Выписки по API банка → Проверить подключение

1. Нажмите «Проверить подключение».
2. Должно появиться «Подключение работает: банк видит счёт …».

Подробно: Проверка ничего не загружает — только спрашивает у банка, принят ли токен и есть ли среди его счетов ваш. Ошибка — смотрите последний шаг «Ответы банка»: там каждая надпись и что делать.

## Шаг 5. Загрузите и сверьте выписку

Где в программе: Выписки по API банка → Синхронизировать сейчас

1. Нажмите «Синхронизировать сейчас» — операции появятся в «Операциях», неясные — в «На проверке».
2. Сверьте первые дни и остаток с выпиской из интернет-банка.
3. При работающей программе выписки загружаются по расписанию. Интервал задаётся в «Настройки → Подключения».

Подробно: Повторы не задваиваются. Та же проверка, что у файла: операция, уже загруженная из файла или почты, второй раз не появится; перевод между своими счетами в двух банках учитывается один раз. Можно сочетать: API у одного банка, почта у другого, файл у третьего. Интервал — «Настройки → Подключения».

## Шаг 6. Ответы банка

Где в программе: Выписки по API банка → надпись у кнопок

1. «банк отклонил токен (401 / 403)» — скопирован не целиком, отозван, истёк или без прав: выпустите новый.
2. «счёта … среди его счетов нет» — проверьте номер счёта в БЭФИ или выпустите токен на этот счёт.
3. «не указан БИК» (Точка) — заполните БИК в карточке счёта. «выписка ещё готовится» — повторите через минуту.

Подробно: «Компьютер не доверяет сертификату банка» — банк на российском сертификате (НУЦ Минцифры): установите корневой сертификат с gosuslugi.ru/crt и повторите. «Нет связи с банком» — проверьте интернет; на сервере — что исходящие подключения не закрыты. Остаток не сходится — проверьте дату начала учёта и остаток на неё: операции до начала учёта не загружаются.

## Важно

Первую синхронизацию обязательно сверьте с выпиской из интернет-банка за те же дни — операции и остаток. Что-то не совпало — напишите в поддержку БЭФИ: адаптеры банков сделаны по их документации, и первая сверка на живом счёте важна.

Страница с иллюстрациями: instrukciya-bank-po-api.html. Все инструкции: instrukcii.html. Скачать БЭФИ: download.html.