Пошаговая инструкция

Подключение Модульбанка

Один токен из личного кабинета — и бот заполнит реквизиты, будет отправлять платёжки в банк, покажет баланс и выписку, сам отметит оплаченные счета и выставит QR СБП к каждому счёту.

Полезные ссылки Модульбанка

Что понадобится

  1. Расчётный счёт в Модульбанке и доступ к личному кабинету
  2. Адрес уведомлений: https://bot.moibuhrf.ru/api/modulbank/webhook — по нему банк сообщает боту об оплатах
  3. 5 минут на настройку
Токен действует три года; отключить его можно в боте в любой момент

Шаги подключения

1
Откройте выпуск токена
Браузер

В личном кабинете Модульбанка откройте Настройки → Услуги → API банка → Генерация токена (в меню «+» пункт называется «Интеграция с банком»).

2
Отметьте права
Браузер

Боту нужны три права:

  • account-info — реквизиты, счета и баланс;
  • operation-history — выписка и уведомления об оплатах;
  • operation-upload — отправка платёжек и QR СБП.
С правом operation-upload бот только создаёт платёжки — черновиками. Деньги уходят после вашей подписи.
3
Укажите адрес уведомлений
Браузер

В поле адреса для уведомлений (веб-хука) вставьте:

https://bot.moibuhrf.ru/api/modulbank/webhook

По нему банк сообщает о каждом поступлении — бот находит ваш счёт и отмечает его оплаченным, а вам пишет «Счёт № … оплачен».

Без адреса всё остальное работает, но об оплатах бот узнает только по кнопке «Сверить оплаты» в /modulbank.
4
Скопируйте токен
Браузер

Нажмите «Сгенерировать» и скопируйте токен целиком.

Токен — это доступ к счёту. Не пересылайте его никому, кроме бота.
5
Пришлите токен боту
Telegram / MAX

Напишите боту /modulbank (или «подключи банк» → Модульбанк) и отправьте токен сообщением. Если счетов несколько — выберите, с какого отправлять платёжки.

Сообщение с токеном бот сразу удаляет, а хранит токен в зашифрованном виде.

Готово — Модульбанк подключён

В /modulbank теперь есть:

  • Баланс — остаток, доступный овердрафт и остаток на любую дату;
  • Выписка — все операции, отдельно поступления и списания;
  • Сверить оплаты — бот пройдёт поступления за 30 дней и отметит оплаченные счета;
  • СБП и QR — регистрация точки продаж, QR на сумму к каждому новому счёту, возврат оплаты, кассовая ссылка (постоянный QR у кассы);
  • Подписать КЭП — подписать платёжки квалифицированной подписью прямо из бота (КриптоПро);
  • Сменить счёт и Отключить — при отключении токен отзывается в банке.

Платёжки: пришлите счёт поставщика (PDF или фото) или продиктуйте «заплати ИП Иванову 35 000 через Модульбанк» — бот создаст ПП и отправит её в банк черновиком. Пачку счетов бот загружает одним файлом.

Управление интеграцией: /modulbank