Содержание статьи
Коротко о главном
- Цифровые товары и услуги в боте и мини-приложении продаются только за Telegram Stars. За обход этого правила бот могут убрать из версий Telegram в магазинах приложений.
- Физические товары и офлайн-услуги оплачиваются картой через стороннего провайдера. Telegram комиссию не берёт, у провайдера она своя.
- Криптовалюту в мини-приложениях можно принимать только в сети TON и только через TON Connect.
- Товар выдают после сообщения об успешной оплате, а не после подтверждения заказа. Идентификатор платежа сохраняют для возврата.
- Заработанные звёзды становятся доступны через 21 день и действуют 3 года.
Художница, которая ведёт курсы акварели, запускает бота: открыть видеоурок стоит небольших денег. Первая мысль — подключить оплату картой, ведь так привычнее покупателям. Но видеоурок — цифровой товар, а для цифрового в Telegram действует одно правило: только Stars.
С Telegram-ботами вопрос «чем принимать деньги» решается не сравнением комиссий. Сначала определите, что вы продаёте, и правила сами подскажут способ. Ошибка здесь может стоить самого бота.
- 21 день
- Через столько заработанные ботом звёзды становятся доступны для награды или рекламы.
- 10 секунд
- Столько есть у бота, чтобы подтвердить заказ перед оплатой.
- 0 %
- Комиссия Telegram за платежи картой через провайдера. Провайдер берёт свою.
С чего начать
Главное правило: тип товара
- Цифровое — доступ к урокам, подписка, файлы, функции бота, игровые предметы. Только Telegram Stars. Так требуют App Store и Google Play: Telegram обязан следовать их правилам о цифровых товарах. Если бот принимает за цифровое другие способы оплаты, владельцу придёт предупреждение, а затем бот могут сделать недоступным в версиях Telegram из магазинов приложений или отключить.
- Физическое — товары с доставкой, услуги в реальном мире. Оплата картой через стороннего платёжного провайдера, валюта — обычные деньги.
- Криптовалюта. Если мини-приложение работает с криптовалютой, то только с сетью TON, а кошельки подключаются только через TON Connect. Цифровые товары при этом всё равно продаются за Stars.
Где проходит граница между цифровым и физическим, определяют правила Apple и Google, и они меняются. Если товар на границе, сверяйтесь с их актуальными требованиями.

Таблица
Сравнение способов
Что продаёте | Чем принимать | Правила и комиссии | Как получаете деньги |
|---|---|---|---|
Цифровые товары и услуги | Telegram Stars (валюта XTR) | Покупатель покупает звёзды через App Store, Google Play или @PremiumBot. Данные карты в бот не вводит | Звёзды на балансе бота. Через 21 день их можно обменять на награду через Fragment или потратить на рекламу. Действуют 3 года |
Физические товары и офлайн-услуги | Карта через провайдера, подключённого в BotFather | Telegram комиссию не берёт, провайдер — свою. Сумма примерно от 1 до 10 000 долларов | На счёт у провайдера по его правилам |
Оплата криптовалютой | GRAM или токены TON через TON Connect в мини-приложении | Только сеть TON. Цифровое — всё равно за Stars | Сразу на ваш адрес в TON. Возвраты — вручную |
О том, чем Stars отличаются от GRAM и почему их путают, — в статье «Telegram Stars и GRAM: в чём разница и почему путаница стоит денег».
Цифровые товары
Stars: как выглядит оплата в коде
Порядок у любого бота один:
- Отправьте счёт методом sendInvoice с валютой XTR. Токен провайдера для звёзд не нужен.
- Подтвердите заказ в ответ на pre_checkout_query методом answerPreCheckoutQuery в течение 10 секунд, иначе платёж отменится.
- Выдайте товар только после successful_payment. Подтверждение заказа ещё не значит, что деньги пришли.
- Сохраните telegram_payment_charge_id — без него не сделать возврат.
Фрагмент ниже продолжает бота из статьи «Как создать бота в Telegram: BotFather, первый код на Python и одно правило про токен»: функция call там уже есть.
# Счёт на цифровой постер за 50 звёзд
def send_poster_invoice(chat_id):
call(
"sendInvoice",
chat_id=chat_id,
title="Цифровой постер",
description="Файл PNG в высоком разрешении",
payload="poster-001",
provider_token="", # для звёзд оставляют пустым
currency="XTR", # Telegram Stars
prices=[{"label": "Постер", "amount": 50}],
)
def handle_payment_update(update):
query = update.get("pre_checkout_query")
if query:
# Проверьте, что товар есть, и ответьте за 10 секунд
call("answerPreCheckoutQuery", pre_checkout_query_id=query["id"], ok=True)
return
payment = update.get("message", {}).get("successful_payment")
if payment:
charge_id = payment["telegram_payment_charge_id"]
save_charge(charge_id) # сохраните для возможного возврата
deliver_poster(update["message"]["chat"]["id"])
def refund(user_id, charge_id):
call("refundStarPayment", user_id=user_id, telegram_payment_charge_id=charge_id)Функции save_charge и deliver_poster — ваши: первая записывает платёж в базу, вторая отправляет покупателю файл.
Правила платформы
Обязанности продавца
- Поддержка. Бот должен отвечать на команду /paysupport и разбирать вопросы об оплате. Нужны также понятные условия, например по команде /terms, и способ связаться с вами.
- Споры — ваши. Telegram не посредничает между продавцом и покупателем. Если не получается выполнить заказ, верните звёзды через refundStarPayment: правила платформы прямо разрешают это без штрафа.
- Последствия. За нерешённые обоснованные жалобы Telegram может списать звёзды с баланса, убрать бота из магазинных версий, повесить метку SCAM и закрыть аккаунт владельца. Звёзды также могут удержать, если покупатель вернул деньги за их покупку через магазин приложений.
Платёжные провайдеры
Карта: физические товары
Оплата картой подключается в BotFather: /mybots → ваш бот → раздел платежей → выбор провайдера. Провайдер выдаст токен, который передаётся в sendInvoice. Пока вы тестируете, используйте тестовый режим Stripe: в нём платежи проходят без списаний, с тестовыми картами.
Для физических товаров бот может запросить имя, телефон, почту и адрес доставки, предложить варианты доставки и чаевые. Данные карты получает провайдер, а не бот и не Telegram. Поэтому и возвраты, и споры по картам решаются с провайдером по его правилам.
GRAM и токены
Криптовалюта: только TON
Правила платформы для мини-приложений строгие: всё, что связано с криптовалютой, — только в сети TON, кошельки — только через TON Connect, рекламировать кошельки и активы других сетей нельзя. Покупатель подтверждает перевод в своём кошельке, и деньги сразу приходят на ваш адрес.
Такой способ подходит для физических товаров и услуг, если ваши покупатели и так держат GRAM или USDT в TON. Возвраты придётся делать вручную обычным переводом, а цену в GRAM — пересчитывать, потому что курс меняется. Как устроены мини-приложения, разобрано в статье «Что такое Mini Apps в Telegram и как они работают».
Вопросы
Когда можно вывести заработанные звёзды?
Через 21 день после получения. Звёзды обмениваются на награду через Fragment, а минимальная сумма и порядок описаны в статье «Как вывести Telegram Stars: путь от звёзд канала до GRAM».
Раз Telegram дружит с TON, можно продавать цифровое за GRAM?
Нет. Правило о цифровых товарах касается любых способов оплаты, кроме Stars, включая криптовалюту. TON-интеграция разрешает криптовалюту, но не отменяет требование магазинов приложений.
Берёт ли Telegram комиссию?
За платежи картой через провайдера — нет. Со звёздами схема другая: покупатель платит магазину приложений за звёзды, а вы получаете звёзды и обмениваете их по ставке, которую назначает Telegram. Отдельная комиссия 15% появляется, если включить в боте темы в личных чатах.
Способ оплаты в боте выбирает товар. Цифровое — за Stars, физическое — картой через провайдера, криптовалюта — только в TON и для тех, кто к ней готов. Перепутать здесь значит рискнуть самим ботом.
Дальше всё решает аккуратность в коде: товар выдаётся только после успешной оплаты, идентификатор платежа сохраняется, команда /paysupport работает. Этого достаточно, чтобы деньги приходили, а споры не превращались в санкции.


