Оплата в Telegram-боте: Stars, карты и криптовалюта

Приём оплаты в Telegram-боте устроен не как на сайте: способ платежа определяется не вашим желанием, а тем, что вы продаёте. Цифровые товары и подписки продаются только за Telegram Stars — внутреннюю валюту мессенджера. Физические товары и услуги — картами через подключённого платёжного провайдера. Отдельным контуром идёт криптовалюта.

Это не рекомендация, а правило платформы: Telegram не показывает мобильным пользователям ботов, которые пытаются продавать цифровые товары в других валютах или через сторонних провайдеров. Так мессенджер выполняет требования App Store и Google Play, где продажа цифрового контента идёт только через платёжные системы самих магазинов.

Два контура — и почему их нельзя перепутать

Граница проходит по природе товара, и определить её нужно до начала разработки.

Цифровое — доступ к каналу, подписка, консультация в записи, курс, снятие лимитов внутри бота, виртуальные предметы. Только Stars.

Физическое — товар с доставкой, а также услуги, оказываемые в офлайне. Здесь работает обычный платёжный провайдер, и валюта может быть любой из поддерживаемых.

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

Telegram Stars: как это работает

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

Что это даёт бизнесу:

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

Обратная сторона — деньги приходят не сразу и не полностью.

Вывод денег и комиссии

Обработку выплат Telegram передал Fragment. Три момента, которые стоит заложить в финансовую модель заранее, — все они зафиксированы в условиях для разработчиков ботов:

• Вы получаете 0,013 USD за звезду. Это не «комиссия при выводе», а закреплённая ставка вознаграждения: пользователь платит за звезду заметно больше, потому что сверху сидит комиссия App Store или Google Play. Считать выручку нужно от 0,013, а не от того, что видит покупатель.
• Заморозка до 21 дня с момента получения каждой звезды: по формулировке Telegram, звёзды «могут стать недоступны для вывода на срок до 21 дня после получения». Заработанное сегодня доступно примерно через три недели.
• Выводятся только заработанные звёзды. Те, что вы купили сами, вывести нельзя — их можно только потратить внутри Telegram.

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

Оплата картой через платёжного провайдера

Для физических товаров сценарий ближе к привычному интернет-магазину. В @BotFather подключается платёжный провайдер, бот получает provider_token и выставляет счёт этим токеном. Пользователь платит картой, деньги идут на ваш расчётный счёт по договору с провайдером.

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

Если параллельно с ботом у вас работает сайт, помните, что это два разных договора и две разные интеграции: как устроен приём оплаты на сайте, разобрано в отдельной статье.

Криптовалюта в боте

Третий контур — приём криптовалюты через сторонние сервисы на базе TON, которые сами работают как боты и предоставляют API. Через них принимают TON, USDT и ряд других монет.

Это разумный вариант для международной аудитории и для случаев, когда карточный эквайринг недоступен. Минусы обычные для крипты: волатильность, если вы не конвертируете сразу, и собственные требования сервиса к тому, что вы продаёте.

Подписки: где боты зарабатывают больше всего

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

Что нужно предусмотреть, чтобы подписочная модель не начала течь:

Синхронизация доступа со статусом оплаты. Подписку отменили — доступ должен сняться автоматически, в тот же день. Ручная сверка списков работает первые две недели, дальше начинаются потери.

Обработка неудачного продления. У пользователя не хватило звёзд, продление не прошло — нужен сценарий: напоминание, льготный период, затем отключение. Без него человек просто молча уходит.

История платежей в своей базе. Кто, когда, за что и на какой срок. Telegram — не ваша бухгалтерия, и выгрузить оттуда отчёт за квартал в удобном виде не получится.

Понятная отмена. Кнопка отмены внутри бота снижает число обращений в поддержку и споров. Спрятанная отмена даёт обратный эффект: люди идут не в поддержку, а в возвраты.

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

Возвраты и споры

Возврат платежа в звёздах выполняется методом refundStarPayment. Важная деталь: Telegram явно возлагает разбор пользовательских споров на владельца бота — площадка не выступает арбитром между вами и клиентом.

Из этого следует и формальная обязанность, о которой забывают: бот, принимающий платежи, должен обрабатывать команду /paysupport и объяснять пользователю, как получить помощь по оплате. Это не рекомендация по UX, а требование условий Telegram для разработчиков.

Практический вывод: правила возврата должны быть описаны в боте до покупки, /paysupport — отвечать осмысленным текстом, а в админке должна быть кнопка возврата. Разбирать это вручную через разработчика на третьей неделе продаж — плохая идея.

Что выбрать под задачу

Что учесть при разработке

Идемпотентность платежей. Пользователь нажмёт «оплатить» дважды, уведомление придёт повторно. Без защиты от дублей это два списания и один недовольный клиент.

Хранение фактов оплаты. Идентификатор платежа, сумма, товар, время — в своей базе, а не только в переписке. Без этого невозможно ни разобрать спор, ни свести отчётность.

Разделение доступа. Если за оплату выдаётся доступ к контенту, он должен сниматься при возврате и при отмене подписки. Забытая проверка здесь — самая частая дыра в подписочных ботах.

Проверка данных на своей стороне. Если оплата уходит в Mini App, данные, которые приложение присылает боту, обязательно проверяются подписью на сервере. С 20 июля 2026 года Telegram автоматически включил всем Mini App защиту от вызова их методов с доменов, отличных от исходного (отключается в @BotFather под вашу ответственность), — но серверную проверку подписи это не отменяет.

Тестовые платежи. У Stars и у провайдеров разные способы проверки сценария до боевого запуска. Прогонять покупку, продление и возврат нужно до того, как бот увидят пользователи, — ошибка в оплате обнаруживается не в логах, а в сообщении от разозлённого клиента.

Порядок работ обычно такой: определяем природу товара, выбираем контур, проектируем сценарий покупки и возврата, и только потом пишем код. Сколько стоит бот с оплатой и из чего складывается цена — в разборе «Сколько стоит Telegram-бот», а посмотреть, что мы делаем с ботами и Mini Apps, можно на странице услуги.

Правила платформы и комиссии меняются — перед запуском их стоит сверить с актуальной документацией Telegram.