Перевод платежей Telegram-бота на Stars: гид по Stripe и ЮKassa

Перевод платежей Telegram-бота на Stars: гид по Stripe и ЮKassa

Коротко. Если бот продаёт цифровой товар или услугу — подписку, пакет данных, дополнительные функции — Telegram требует оплату в Stars (XTR), а не через Stripe или ЮKassa. Это правило действует с момента запуска Stars и не является новостью. Физические товары продолжают работать на привычном фиатном провайдере. Настоящая миграция — это параллельная работа двух рельсов: один инвойс — одна валюта, никогда не смешанные, до тех пор, пока каждая цифровая позиция не перейдёт на Stars, а физическая — не останется на месте. Но для большинства российских операторов ботов вопрос "как уйти со Stripe" звучит странно: Stripe там никогда и не работал.

Хотите перестать переключаться между консолями оплат и планированием постов вручную? Autogram берёт автопостинг на себя, пока вы разбираетесь с платежами.

Что проверить перед началом

• Какие позиции бота цифровые? Подписки, внутренние валюты бота, дополнительные уровни или использования, "похожие нематериальные товары", продаваемые внутри приложения Telegram — всё это подпадает под требование Stars.
• Какие товары физические или доставляются вне Telegram? Товар с доставкой, офлайн-услуга, счёт за работу, выставленный вне платформы — на это требование Stars не распространяется, и Stripe или ЮKassa продолжают работать как прежде.

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

Шаг 1 — Факт, который часто упускают: Stripe тут и не работал

Правило, буквально из официальной документации Telegram Bot Payments API (проверено в сентябре 2026): цифровые товары и услуги, продаваемые через ботов и мини-приложения, должны оплачиваться исключительно в Telegram Stars. Telegram объясняет это соответствием политикам Apple и Google о покупках внутри приложения — Stars это ответ Telegram на то же правило, которому подчиняется любое приложение, распространяемое через App Store или Google Play.

Для российского оператора здесь есть более прямой факт: собственная страница санкций Stripe прямо говорит, что Stripe не обслуживает пользователей, находящихся в России, Украине или Беларуси. Это значит, что "миграция со Stripe" для российского бота — это не шаг 1, а вопрос, который не должен был возникать: реальной точкой отсчёта всегда была ЮKassa (документация по интеграции с Telegram-ботами остаётся актуальной, последнее обновление — апрель 2026 года) или другой локальный провайдер, а не Stripe.

Отдельный слой контекста для трансграничных сценариев: с 25 января 2026 года 19-й пакет санкций ЕС запрещает организациям из ЕС подключаться к российским платёжным системам с функцией финансового обмена сообщениями — включая карточную систему "Мир" и Систему быстрых платежей (СБП). Это не влияет на работу ЮKassa внутри России, но усложняет любые расчёты через европейские рельсы, если часть вашей инфраструктуры находится в ЕС.

Требование Stars не касается физических товаров. Пост о запуске Stars прямо говорит: "покупки физических товаров остаются без изменений — через любого поддерживаемого Telegram платёжного провайдера".

Photo by DS stories on Pexels

Шаг 2 — Запустите оба рельса параллельно ("двойная валюта" на практике)

Вот что API не даёт обойти: один инвойс Telegram — это одна валюта. Согласно чейнджлогу Bot API за май 2024, createInvoiceLink и sendInvoice требуют, чтобы разбивка цен содержала ровно один пункт, когда валюта — XTR, а provider_token для инвойса в Stars должен быть полностью пропущен — нельзя прикрепить токен провайдера к инвойсу в Stars и нельзя указать в одном инвойсе сразу рубли и Stars.

Поэтому "двойная валюта" на практике — это две отдельные ссылки на инвойс, а не один инвойс:

1. Оставляете существующий вызов createInvoiceLink для фиатной цены (через ЮKassa или другого провайдера) без изменений.
2. Добавляете второй вызов createInvoiceLink с currency: "XTR", пустым provider_token и ценой в Stars.
3. Показываете пользователю обе кнопки — и даёте выбрать.

Здесь же большинство команд замечают, что их ценовая сетка не переводится напрямую: Telegram не публикует фиксированный курс, и по оценкам сторонних трекеров курс колеблется примерно в районе $0,013–$0,02 за Star в зависимости от платформы и размера покупки — округляйте цены в Stars до разумных чисел, а не считайте точную конвертацию.

Шаг 3 — Переводите рекуррентную цифровую позицию на Stars, остальное оставляйте на фиате

Для подписок и других рекуррентных цифровых платежей createInvoiceLink и sendInvoice поддерживают subscription_period, но только когда currency — XTR: рекуррентные платежи в Stars не "опциональная валюта", они привязаны к Stars по конструкции. Если переводите рекуррентный цифровой продукт — это момент, когда нужно убрать старый токен провайдера именно для этого продукта, а не держать рекуррентную подписку на ЮKassa "на запас": когда параллельный период заканчивается, у цифрового SKU остаётся ровно один способ оплаты.

Что стоит построить заранее:

• Возвраты. refundStarPayment (добавлен в Bot API 8.0) — это вызов со стороны бота, а не заявка в поддержку Telegram. Встройте это в поддержку прямо сейчас: "все продажи Stars окончательны" со стороны пользователя означает, что ваш бот — единственный путь возврата для покупателя.
• Ожидания по выводу. Stars, которые вы зарабатываете, выводятся через Fragment в TON при минимуме 1000 Stars и с 21-дневной задержкой на каждую партию с момента начисления. Планируйте на это задержку — это не мгновенная выплата, как в карточном эквайринге.

Photo by Tranmautritam on Pexels

Типичные ошибки

• Считать "Stars против Stripe" выбором на уровне всего бота. Это выбор на уровне каждой позиции товара, а не бота целиком. Цифровые и физические позиции могут — и обычно должны — работать на разных рельсах в одном боте.
• Пытаться отправить один инвойс сразу с фиатной и звёздной ценой. API отклонит разбивку цен, которая не является ровно одной валютой — делайте две отдельные ссылки на инвойс.
• Думать, что Stripe когда-то был вариантом для российского бота. Собственная страница санкций Stripe подтверждает, что он не обслуживает пользователей из России, Украины или Беларуси — реальной точкой отсчёта для миграции всегда была ЮKassa, а не Stripe.
• Прогнозировать доход в Stars по номинальной цене. То, что вы получаете за Star, меньше того, что заплатил покупатель, а конвертация Fragment в TON добавляет свой спред — планируйте по сумме начисления, а не по прайс-листу.

Что почитать ещё

• Telegram Star Subscriptions: настройка для рекуррентного дохода — механика subscription_period, на которую опирается шаг 3 этой миграции.
• Возврат Telegram Stars: как на самом деле работает refundStarPayment — постройте это до того, как убираете старый флоу возвратов.
• TON в фиат для владельцев каналов: вывод через Fragment — что происходит после того, как Stars попали на баланс.
• Монетизация Telegram Stars: набор инструментов для канала 2026 — более широкая картина монетизации, не только платежи бота.

FAQ

Нужно ли переводить на Stars всё, что продаёт бот?

Нет — только цифровые товары и услуги, продаваемые внутри приложения Telegram: подписки, внутренние валюты бота, дополнительные функции и похожие нематериальные товары. Физические товары и офлайн-услуги могут оставаться на Stripe, ЮKassa или любом другом поддерживаемом провайдере.

Может ли один инвойс иметь и фиатную цену, и цену в Stars?

Нет. createInvoiceLink и sendInvoice требуют, чтобы разбивка цен содержала ровно один пункт, когда currency — XTR, и отклонят смешанную позицию фиат-плюс-Stars. Предлагайте две отдельные ссылки на инвойс и дайте покупателю выбрать.

Работает ли Stripe в России вообще?

Нет — собственная страница санкций Stripe прямо говорит, что он не обслуживает пользователей, находящихся в России, Украине или Беларуси. Реальным вариантом для российского бота всегда была ЮKassa или другой локальный провайдер.

Остаётся ли ЮKassa рабочим вариантом для Telegram-ботов?

Да — собственная документация ЮKassa по интеграции с Telegram-ботами остаётся актуальной, последнее обновление — апрель 2026 года. Это рабочий канал для всего, что не подпадает под обязательное требование Stars для цифровых товаров.

Как санкции ЕС от 25 января 2026 года влияют на приём платежей внутри России?

Они не влияют на работу ЮKassa внутри страны — ограничение касается подключения организаций из ЕС к российским платёжным системам (карточная система "Мир", СБП). Это важно, только если часть вашей расчётной инфраструктуры проходит через ЕС.

Как работают возвраты на Stars?

Через метод Bot API refundStarPayment, добавленный в Bot API 8.0 — ваш бот должен вызывать его самостоятельно. Условия Telegram говорят, что покупки в Stars окончательны со стороны покупателя, поэтому если бот не доставил обещанное — ваш бот является единственным путём возврата для покупателя.

Сколько времени занимает вывод заработанных Stars?

Вывод через Fragment требует минимума 1000 Stars на балансе, и каждая партия Stars разблокируется через 21 день с момента начисления — планируйте денежный поток с учётом этой задержки, а не мгновенной выплаты.

Итог

Тарифы в Autogram. Подключите первый канал и получите 7 дней доступа к Solo с AI-бюджетом $1. Банковская карта не нужна.

Источники изображений

• Главное: Photo by Mikhail Nilov on Pexels
• Встроенное 1: Photo by DS stories on Pexels
• Встроенное 2: Photo by Tranmautritam on Pexels