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

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

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

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

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

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

Откройте настройки блока. В поле «Платёжный сервис» выберите Telegram. В разделе «Счёт на оплату» оставьте способ оплаты «Звёзды Telegram».

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

• Название товара — до 32 символов. Это заголовок счёта.
• Описание — до 255 символов. Что получит покупатель.
• Цена в звёздах — целое число, минимум 1.
• Время ожидания, сек. — необязательное поле в разделе «Ожидание оплаты». Когда время выходит, сценарий сам не переходит в Не оплачено (подробнее ниже).

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

В названии и описании можно выбирать переменные, чтобы подставить данные покупателя. Цена задаётся в блоке целым числом и не зависит от языка. Две цены — два блока.

Название и описание можно перевести через переключатель языка в редакторе. Цена и валюта останутся общими. Если перевода нет, покупатель увидит исходный текст. Подробнее — в руководстве «Мультиязычные боты».

Токен провайдера — секретный ключ, который связывает бота с платёжной компанией. Выберите способ оплаты «Банковская карта». Подсказка рядом с полем объясняет настройку.

Поле «Сумма в копейках или центах» здесь означает цену в минимальных единицах валюты. 999 при валюте USD — это 9,99 доллара.

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

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

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

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

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

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

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

• Для регулярной оплаты выберите режим «Подписка». Создайте тариф в «Заказы → Платежи», затем выберите его в блоке оплаты. Подробнее: Подписки в боте. Оплата подписки картой недоступна.
• Нет возвратов. В FlowCastle нет действия или кнопки возврата. Возврат по карте делают в личном кабинете провайдера.
• Не работает в операциях. У операции по расписанию некому выставить счёт, поэтому блок оплаты живёт только в сценариях чата.

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

Криптовалюту этот блок не принимает. Чтобы брать оплату в USDT, TON, BTC и других монетах, установите модуль Crypto Pay: он отправляет кнопку оплаты через @CryptoBot, ждёт и продолжает сценарий, когда оплата подтверждена.

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

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