Приём оплаты в 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 — отвечать осмысленным текстом, а в админке должна быть кнопка возврата. Разбирать это вручную через разработчика на третьей неделе продаж — плохая идея.
#Что выбрать под задачу
| Что продаёте | Способ | Что нужно | Скорость запуска |
|---|---|---|---|
| Подписка, доступ, курс | Telegram Stars | Ничего, кроме бота | Дни |
| Товар с доставкой | Провайдер + карты | Юрлицо, счёт, договор | Недели |
| Международная аудитория | Крипта через TON-сервис | Аккаунт в сервисе | Дни |
| Смешанный каталог | Stars + провайдер | Оба контура | Недели |
#Что учесть при разработке
Идемпотентность платежей. Пользователь нажмёт «оплатить» дважды, уведомление придёт повторно. Без защиты от дублей это два списания и один недовольный клиент.
Хранение фактов оплаты. Идентификатор платежа, сумма, товар, время — в своей базе, а не только в переписке. Без этого невозможно ни разобрать спор, ни свести отчётность.
Разделение доступа. Если за оплату выдаётся доступ к контенту, он должен сниматься при возврате и при отмене подписки. Забытая проверка здесь — самая частая дыра в подписочных ботах.
Проверка данных на своей стороне. Если оплата уходит в Mini App, данные, которые приложение присылает боту, обязательно проверяются подписью на сервере. С 20 июля 2026 года Telegram автоматически включил всем Mini App защиту от вызова их методов с доменов, отличных от исходного (отключается в @BotFather под вашу ответственность), — но серверную проверку подписи это не отменяет.
Тестовые платежи. У Stars и у провайдеров разные способы проверки сценария до боевого запуска. Прогонять покупку, продление и возврат нужно до того, как бот увидят пользователи, — ошибка в оплате обнаруживается не в логах, а в сообщении от разозлённого клиента.
Порядок работ обычно такой: определяем природу товара, выбираем контур, проектируем сценарий покупки и возврата, и только потом пишем код. Сколько стоит бот с оплатой и из чего складывается цена — в разборе «Сколько стоит Telegram-бот», а посмотреть, что мы делаем с ботами и Mini Apps, можно на странице услуги.
Правила платформы и комиссии меняются — перед запуском их стоит сверить с актуальной документацией Telegram.