# Т‑Банк

Source: https://docs.botman.pro/a/145-t-bank

## **Создания аккаунта**

1. Перейдите на сайт [Т-Банка](https://www.tbank.ru/kassa/) и нажмите "Подключить".
2. После одобрения получите доступ к личному кабинету и настройкам приёма платежей.
3. Вся информация по регистрации есть на сайте Т-Банка в [этой инструкции](https://www.tbank.ru/business/help/business-payments/internet-acquiring/how-use/terminal/?card=q2).

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

1. Перейдите по ссылке: [Настройки магазина](https://business.tinkoff.ru/oplata/mpa/shops/ecom).
2. Выберите нужный магазин, затем откройте Терминал → Рабочий → Настроить.
3. В поле «По протоколу HTTP» вставьте ссылку: ***https://s.botman.pro/tinkoff***
4. Заполните страницы для перехода после оплаты (например, страницу «Спасибо за покупку»).
5. Нажмите «Сохранить».
6. Проверьте введённые данные и удалите лишние пробелы.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/4715ef1e720a050dc95f95ca1925ca668f3e9d224ef6f5a293621470d13eed80.png)

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

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

1. Перейдите по ссылке: [Создание платёжной страницы.](https://app.botman.pro/app/integration/tinkoff-payment)
2. Укажите все необходимые данные, важные параметры выделены звездочкой (\*).

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

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

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

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

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

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

📌 [Что такое динамичная цена?](https://docs.botman.pro/a/91-dinamicheskaya-tsena)\
Фактическая сумма, которую должен оплатить покупатель.

![](https://storage.yandexcloud.net/botman-knowledge-prod/kb/6aec5304d3ac9dc31d82ccf6/682c4d5c54009b89d63ef644c01fa9e9806382ffba9e84fc60f0301d6121259d.png)

---

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

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

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

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

- НДС
- система налогообложения
- предмет расчёта
- способ расчёта
- данные товара или услуги

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

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

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

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

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

- Предоплата 100%
- или Полный расчёт

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

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

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

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

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

---

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

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

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

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

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

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

---

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