Деньги и банк

Банк по API

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

В режиме «Подробно» — тонкости и особые случаи к каждому шагу.

Скачать инструкцию — PDF

Содержание

1Токен — только на чтение
2Где токен в вашем банке
3Вставьте токен в БЭФИ
4Проверьте подключение
5Загрузите и сверьте выписку
6Ответы банка

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

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

1

Шаг 1 из 6

Токен — только на чтение

Интернет-банк→Интеграции / API

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

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

2

Где это в программе

Пример · Интернет-банк

1 только чтение → 2 платежи не нужны → 3 «Выпустить»

3

Шаг 2 из 6

Где токен в вашем банке

Т-Банк · Точка · Модульбанк

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

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

4

Где это в программе

Пример · Где выпустить токен

1 найдите свой банк — меню в интернет-банке

5

Шаг 3 из 6

Вставьте токен в БЭФИ

Справочники→Мои счета→ваш счёт

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

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

6

Где это в программе

Пример · БЭФИ

1 банк → 2 токен → 3 «Сохранить подключение»

7

Шаг 4 из 6

Проверьте подключение

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

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

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

8

Где это в программе

Пример · БЭФИ

1 «Проверить подключение» → зелёная надпись

9

Шаг 5 из 6

Загрузите и сверьте выписку

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

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

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

10

Где это в программе

Пример · БЭФИ

1 проверьте статью → 2 подтвердите проверенные операции

11

Шаг 6 из 6

Ответы банка

Выписки по API банка→надпись у кнопок

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

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

12

Где это в программе

Пример · Что пишет БЭФИ

1 надпись → что сделать

13

Другие инструкции

Начало работы