Бот работает круглосуточно и приносит пользу. Логичный следующий вопрос: может ли он принимать оплату? Может — у Telegram для этого есть собственная механика. Но правила жёсткие, и незнание их — самый короткий путь к отменённым платежам и ограничениям бота. Разбираем только механику: честно, без «заработаешь миллион».

Stars — внутренняя валюта Telegram

Telegram Stars — внутренняя валюта Telegram (в платёжных запросах она обозначается кодом XTR): пользователь покупает «звёзды» прямо в приложении и расплачивается ими внутри мессенджера. Главное правило платформы: цифровые товары и услуги внутри Telegram продаются только за Stars. Подписка на твоего ИИ-консультанта, доступ к урокам, генерации картинок — всё это цифровое, значит — Stars и только Stars. Физические товары — пицца, букет, футболка с доставкой — наоборот, продаются через обычных платёжных провайдеров, картой.

Правило-эвристика урока: цифровое внутри Telegram — Stars; физическое — карта. Заблуждение «возьму за подписку оплату картой напрямую, так привычнее» — прямое нарушение правил платформы: такому боту грозят ограничения, а платежам — отмена.

Как проходит платёж: счёт → подтверждение → оплата

Счёт (invoice). Бот отправляет пользователю счёт: название, описание, цена в Stars. В коде это метод sendInvoice с валютой XTR, а поле платёжного провайдера (provider_token) остаётся пустым — деньги идут через сам Telegram, внешний банк-посредник не участвует.
Подтверждение (pre-checkout). Перед списанием Telegram спрашивает у бота: «подтверждаешь заказ?» — и ждёт ответа не больше 10 секунд. Не успел — платёж отменяется.
Оплата. Бот получает сообщение об успешном платеже — и выдаёт то, за что заплатили: включает подписку, открывает доступ.

Подумай, прежде чем читать дальше: зачем вообще шаг подтверждения — почему не списывать сразу? Затем, что за эти 10 секунд бот успевает проверить: товар ещё доступен? место в группе не кончилось? акция не истекла? Pre-checkout — последняя возможность отказаться до того, как деньги ушли, и именно здесь живёт защита от продажи того, чего уже нет.

Возвраты и подписки — встроены

Возврат — часть платформы: у бота есть метод refundStarPayment, который по твоей команде возвращает пользователю уплаченные Stars. Политику возвратов — «возвращаем в течение 48 часов, если подписка не использовалась» — придумываешь ты; механика уже готова.

Подписки тоже встроены: при выставлении счёта указывается период продления (subscription_period), и Telegram сам списывает Stars каждый период. Важное ограничение: разрешённый период сейчас ровно один — 30 дней. Недельных и годовых подписок за Stars нет; недельный доступ оформляй разовым платежом.

Честно про вывод денег

Теперь неудобная часть, о которой молчат продавцы «ботов-миллионников». По данным вторичных источников (официальной сводки Telegram не публикует — актуальные условия проверяй сам):

когда пользователь покупает Stars с телефона, около 30% цены забирают магазины приложений — до тебя эта доля не доходит;
вывод разработчику идёт через платформу Fragment: холд около 21 дня и минимальный порог — 1000 Stars;
ориентир курса — около $0.013 за одну Star.

Вывод из этого антихайповый: Stars — механика приёма оплаты, а не источник дохода. Доход приносит продукт, за который людям не жалко платить, — а «сколько ты заработаешь», честный курс не обещает. Сравни с эвристикой первого урока про пути создания ботов: механика — собственность, которой ты владеешь; обещания дохода — чужой маркетинг.

Песочница: спроектируй оплату

Помоги спроектировать оплату в Telegram-боте. Весь контекст вшит сюда:
бот — ИИ-консультант по уходу за комнатными растениями. Бесплатно:
3 вопроса в день. Платно: безлимит на месяц. Правила платформы:
цифровые услуги внутри Telegram продаются только за внутреннюю валюту
Stars; подписка продлевается строго раз в 30 дней; перед списанием бот
обязан за 10 секунд подтвердить платёж (шаг pre-checkout); возврат
делается встроенной командой возврата.
Задание: 1) предложи, что оставить бесплатным и что сделать платным,
с обоснованием; 2) опиши путь пользователя от «хочу подписку» до
успешного платежа по шагам; 3) реши, что именно бот должен проверить
на шаге pre-checkout. Потом смени роль: раскритикуй наш план как
дотошный клиент — задай три неудобных вопроса про оплату и возврат.

И отрепетируй самый нервный разговор владельца платного бота:

Разыграем поддержку платного Telegram-бота. Правила — весь контекст
здесь: подписка стоит 250 Stars в месяц; возврат технически возможен —
у бота есть встроенная команда возврата платежа; политика сервиса:
возвращаем, если подписчик написал в течение 48 часов и не пользовался
безлимитом. Ты — клиент, который купил подписку 5 дней назад, активно
ею пользовался, а теперь требует вернуть Stars и грозит плохим отзывом.
Я отвечаю как владелец бота. После 4–6 реплик выйди из роли и разбери:
где я ответил хорошо, где потерял клиента и как звучал бы идеальный
ответ. Если моих реплик нет — не жди: сыграй обе стороны сам,
помечая реплики владельца как пример, доведи диалог до развязки
и в конце дай тот же разбор — что в примерных ответах владельца
удачно, что нет и как звучал бы идеал.

Что запомнить

Цифровое внутри Telegram — только Stars; provider_token в счёте пуст, потому что платёж идёт через сам Telegram; pre-checkout — 10 секунд на проверку и подтверждение; возврат — refundStarPayment; подписка — только 30 дней. А цифры вывода — комиссия сторов, холд, минимум — держи в голове до того, как обещать клиенту «бот окупится за неделю».

How a bot takes money: Telegram Stars