Как продавать в Telegram за Stars: пошаговая инструкция

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

Почему именно Stars

Правила магазинов приложений Apple и Google требуют, чтобы цифровые товары внутри приложений оплачивались через их платёжные системы. Поэтому Telegram ввёл Stars и требует использовать их для цифровых товаров и услуг внутри ботов. Физические товары и услуги в реальном мире можно по-прежнему оплачивать через обычных платёжных провайдеров.

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

Плюсы для продавца

• Конверсия. Покупателю не нужно уходить на сторонний сайт, вводить карту или копировать адрес кошелька.
• Доверие. Оплата проходит в интерфейсе Telegram, без «подозрительных» ссылок.
• Нет чарджбэков со стороны покупателя напрямую к вам — споры решаются по правилам Telegram, а бот может сам вернуть звёзды.

Минусы

• Комиссии. Часть суммы уходит магазинам приложений и на конвертацию, поэтому чистая выручка в Stars ниже, чем при прямой оплате криптой.
• Вывод не мгновенный. Заработанные звёзды выводятся через Fragment в TON после периода удержания (на момент написания — около трёх недель). Планируйте оборотные средства с запасом.

Как подключить оплату за Stars

1. В коде бота отправьте счёт (invoice) с валютой XTR и ценой в звёздах — токен платёжного провайдера для Stars не нужен.
2. Обработайте событие pre_checkout_query: проверьте, что заказ актуален и цена совпадает, и подтвердите его.
3. После события successful_payment сохраните идентификатор платежа и выдайте товар.
4. Добавьте команду или кнопку поддержки по платежам — Telegram требует, чтобы у покупателя был способ связаться с продавцом.

Важно сделать обработку идемпотентной: если Telegram пришлёт событие повторно, товар не должен выдаться дважды.

Как назначить цену в звёздах

Удобно хранить цены в долларах и пересчитывать в звёзды по фиксированному курсу (например, 50 звёзд за $1) с округлением вверх. Так цены на сайте и в боте остаются согласованными, а курс легко поменять в одном месте.

Возвраты

Бот может вернуть звёзды покупателю методом refundStarPayment. Пропишите правила возврата в условиях магазина и в описании товара — это снижает число споров.

Сайт + бот: как совместить

Частая схема: в боте оплата за Stars, а на сайте — криптой и картой. Покупатель выбирает, где ему удобнее, а лицензия или товар выдаются одинаково. Именно так устроены магазины на нашей платформе: Stars в боте, CryptoBot и карты на сайте, общий личный кабинет.

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