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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Оплачено — основной путь: отправьте файл, дайте ссылку, поставьте тег, подпишите покупателя на цепочку сообщений.

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

Само по себе время ничего не запускает. Если человек просто замолчал, сценарий не перейдёт в Не оплачено — даже если заполнено поле Wait for payment, seconds. Поэтому не пишите в этой ветке «напомним через 15 минут». Пишите ответ на то сообщение, которое человек только что прислал.

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

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

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

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

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

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