Т‑Банк

Создания аккаунта¶

1. Перейдите на сайт Т-Банка и нажмите "Подключить".

2. После одобрения получите доступ к личному кабинету и настройкам приёма платежей.

3. Вся информация по регистрации есть на сайте Т-Банка в этой инструкции.

Настройка отправки уведомлений об оплате Т‑Банка¶

1. Перейдите по ссылке: Настройки магазина.

2. Выберите нужный магазин, затем откройте Терминал → Рабочий → Настроить.

3. В поле «По протоколу HTTP» вставьте ссылку: https://s.botman.pro/tinkoff

4. Заполните страницы для перехода после оплаты (например, страницу «Спасибо за покупку»).

5. Нажмите «Сохранить».

6. Проверьте введённые данные и удалите лишние пробелы.

📌 Зачем это нужно?
Настройка уведомлений позволяет вашему боту в BotMan автоматически получать информацию об успешных платежах. Без этого бот не сможет подтвердить оплату и выполнять дальнейшие действия.

Создание платёжной страницы в BotMan¶

1. Перейдите по ссылке: Создание платёжной страницы.

2. Укажите все необходимые данные, важные параметры выделены звездочкой (*).

★ Название платежной страницы
Придумайте уникальное название, чтобы легко находить платежную страницу в нашем сервисе.

★ ID Терминала
Уникальный идентификатор терминала, который используется для интеграции с Т-Банком.

★ Пароль для доступа к API
Секретный ключ для аутентификации запросов к API Т-Банка. Храните его в безопасном месте.

★ Название товара
Короткое и понятное название, которое увидит покупатель. Например, «Курс английского» или «Подписка на сервис».

☆ Описание
Дайте покупателю краткую информацию о товаре или услуге.
— Укажите особенности, условия или примечания.
— Рекомендуем заполнить это поле, чтобы интеграция работала без ошибок.

★ Цена
Сумма, которую должен оплатить покупатель.
Укажите точное значение в выбранной валюте. Минимальная сумма платежа определяется системой Т-Банка и может меняться, рекомендуем проверять актуальные лимиты.

📌 Что такое динамичная цена?
Фактическая сумма, которую должен оплатить покупатель.

Решение ошибок при формировании чека¶

Если при оплате появляется ошибка вида:
Неверные параметры: request.validate.expected.receipt это значит, что Т-Банк не может корректно сформировать чек из переданных данных.

Что такое receipt и почему возникает ошибка

Receipt — это данные, которые платёжная система передаёт в онлайн-кассу для формирования чека. В них входят:

• НДС

• система налогообложения

• предмет расчёта

• способ расчёта

• данные товара или услуги

Если хотя бы один из этих параметров указан некорректно или не подходит под тип вашего товара, Т-Банк вернёт ошибку и платёж не пройдёт.

Как исправить

1. Проверьте параметр «Способ расчёта»

Чаще всего проблема именно в нём. Если сейчас выбрано:

Полный расчёт — оплата после передачи предмета расчёта для цифровых товаров, подписок, услуг и ботов корректнее работают значения:

• Предоплата 100%

• или Полный расчёт

Попробуйте изменить значение и провести тестовый платёж.

2. Проверьте, что онлайн-касса полностью подключена в личном кабинете Т-Банка.

3. Убедитесь, что настройки сохранены после изменения — иногда правки не применяются без повторного нажатия «Сохранить».

4. Проверьте обязательные поля в самом Т-Банк — все ли они заполнены (НДС, система налогообложения, предмет расчёта).

✅ Важно: настройки чека задаются на стороне Т-Банка, а не в BotMan. Если после проверки всех пунктов ошибка повторяется, обратитесь в поддержку Т-Банка — они подскажут, какой именно параметр чека не проходит валидацию.

Часто задаваемые вопросы

📌 Где найти ID терминала Т-Банка?
Перейдите в личный кабинет Т-Банка → Магазины → О магазине. В разделе «Идентификаторы» указан ваш Terminal ID.

📌 Где получить пароль для доступа к API?
Перейдите в личный кабинет Т-Банка → Магазины → Терминалы. Выберите «Тестовый» или «Рабочий» терминал → Настроить. В открывшемся окне найдёте поле с паролем для API.

📌 Если у меня несколько товаров/услуг, что делать?
Просто создайте отдельную платежную страницу для каждого товара или услуги.

📌 Сколько страниц я могу создать?
Ограничений нет — создавайте сколько угодно!

✅ Важно:
Убедитесь, что в пунктах со звёздочкой нет лишних пробелов — это может помешать интеграции.

Теперь ваш бот готов принимать платежи через Т-Банк! 🚀
Поздравляем с успешной настройкой! Желаем вам множества успешных продаж и стабильных поступлений! 💰🎉