Приём оплаты в Telegram: Stars и платёжные провайдеры

Гайд

1. 1

   Два способа: звёзды и карты

   Блок «Приём оплаты» отправляет настоящий счёт Telegram прямо из сценария. Человек платит, не выходя из чата, а сценарий продолжается по одному из двух выходов блока: Paid («оплачено») или Not paid («не оплачено»).

   

   У каждого блока один из двух способов оплаты:

   • Telegram Stars — собственная внутренняя валюта Telegram, код валюты XTR. Ни провайдера, ни ключей, ни вебхуков. Цена — целое число звёзд. Для цифровых товаров внутри Telegram нужны именно звёзды.
   • Card — списание реальных денег через платёжного провайдера (например, Stripe), подключённого к боту в @BotFather. Настройка разовая, дальше её используют все блоки с картой у этого бота.
2. 2

   Как добавить блок

   Нажмите кнопку + на холсте и выберите Приём оплаты. То же меню открывается, если потянуть связь из выхода блока и отпустить на пустом месте — тогда новый блок сразу подключён.

   

   На холсте узел показывает название товара, значок Stars или Card и цену. Прайс-лист сценария виден, ничего открывать не нужно.

3. 3

   Звёздам настройка не нужна

   Нажмите на блок — справа откроется редактор. Сверху поле Payment method («способ оплаты»), оставьте Telegram Stars.

   

   Важны четыре поля:

   • Product title — название товара, до 32 символов. Это заголовок счёта.
   • Description — описание, до 255 символов. Что получит покупатель.
   • Price (Stars) — цена, целое число, минимум 1.
   • Wait for payment, seconds (optional) — сколько секунд сценарий держит счёт открытым. Пусто — ждать сколько угодно.

   Поле Currency здесь заблокировано на XTR, вводить ничего не нужно.

   Подписи полей в редакторе пока на английском, даже когда интерфейс русский.

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

4. 4

   Для карты нужен токен провайдера

   Переключите Payment method на Card — редактор сам покажет, что нужно настроить.

   

   Поле Price здесь меняет смысл: это минимальная единица валюты. 999 при Currency USD — это 9,99 доллара.

   Токен принадлежит боту, а не блоку. В Telegram: @BotFather → /mybots → ваш бот → Payments → подключите провайдера. Затем в FlowCastle откройте Настройки → Боты → ваш бот и вставьте токен в поле «Оплата картой (токен провайдера)».

   

   После сохранения метка меняется с «Не подключено» на «Подключено», а бот перезапускается, чтобы подхватить токен. Звёздам всё это не нужно.

5. 5

   Подключите оба выхода

   Paid — счастливый путь: отправьте файл, дайте ссылку, поставьте тег, подпишите покупателя на серию писем.

   Not paid срабатывает, когда человек вместо оплаты пишет сообщение. Нажатие кнопки отказом не считается — сценарий продолжает ждать оплату.

   Что важно помнить: по истечении таймера сам собой не срабатывает никто. Таймаут только заканчивает ожидание, ветку Not paid он не запускает. Поэтому не пишите в этой ветке «напомним через 15 минут» — пишите ответ на то сообщение, которое человек только что прислал.

6. 6

   Сохраните след покупки

   Блок оплаты берёт деньги, но заказ не создаёт. Чтобы покупка попала на страницу «Заказы» и в карточку контакта, поставьте на выход Paid блок «Действие» с действием «Создать заказ» (сумма и валюта). Там же удобно держать «Добавить тег» и уведомление себе через «Уведомить по тегу».

7. 7

   Проверьте до публикации

   Нажмите Тест и пройдите сценарий. Денег никто не теряет: в тестовом чате приходит имитация счёта с заголовком «Тестовый режим — имитация оплаты» и кнопкой «Оплатить … (тест)». Нажмите её — пойдёт ветка Paid; напишите сообщение — ветка Not paid. Потом публикуйте: подробности в статье Тест и публикация бота.

8. 8

   Чего блок не умеет

   • Нет подписок. Только разовое списание. Регулярных платежей в блоке оплаты сегодня нет — ни звёздами, ни картой.
   • Нет возвратов. В FlowCastle нет действия или кнопки возврата. Возврат по карте делают в личном кабинете провайдера.
   • Не работает в операциях. У операции по расписанию некому выставить счёт, поэтому блок оплаты живёт только в сценариях чата.
9. 9

   Когда нужны модули Stripe или YooKassa

   Взять деньги прямо в чате — работа этого блока, модуль для этого ставить не нужно. Модули Stripe и YooKassa нужны, когда деньги собираются в другом месте: на странице оплаты, по карточной подписке или через вебхук, который сообщает боту, что счёт, выставленный вне Telegram, оплачен. Как их устанавливать — в статье Модули: Таблицы, AI, платежи и другие сервисы.

10. 10

    Возьмите готовый шаблон

    Продажа за Telegram Stars — это вся статья в виде рабочего сценария: карточка товара, счёт на 100 звёзд, выдача после оплаты и повторная попытка на втором выходе. Установите и поменяйте цену и тексты.

11. 11

    Что дальше

    Бот умеет брать деньги. Теперь научите его отвечать своими словами: Узел «AI чат-агент».