Как принимать платежи через Telegram Stars для цифровых продуктов

Для цифровых продаж внутри ботов и мини-приложений Telegram требуется Stars. Внешняя страница продукта — другой сценарий; сайт не является обходом правил для продажи внутри бота.

Сначала определите, где оформляется покупка. Продажа цифрового материала внутри бота или мини-приложения Telegram требует Stars. Пост с переходом на самостоятельный сайт — иной путь; перенос формы оплаты не превращает встроенную продажу в разрешённый обход правил.

Если нужен бот с оплатой и выдачей внутри Telegram, заложите отдельную интеграцию и поддержку. Витрина в описанном сценарии принимает оплату через ЮKassa автора либо ручной СБП и открывает доступ на сайте. Подключения Stars в настройках Витрины здесь нет.

Для цифрового товара бот выставляет счёт в валюте XTR. Материал выдаётся только после successful_payment; ответ на pre_checkout_query ещё не означает оплату. Счета могут отправляться в группы и каналы: размещение в канале не отменяет природу счёта.

Разработчику нужно связывать платёж с конкретным заказом и получателем. Перед выдачей сверяйте валюту, сумму и продукт, сохраняйте идентификатор платежа и защищайте повторную обработку от повторной выдачи. Это требования к вашей интеграции, а не функция, которую Витрина автоматически добавляет чужому боту.

Для возврата Stars Bot API предоставляет refundStarPayment с идентификаторами покупателя и платежа. Возврат и прекращение доступа к материалу должны обрабатываться согласованно вашим ботом. Сохранённый пользователем файл невозможно удалить с его устройства.

Не рассчитывайте доход как число Stars, умноженное на цену их покупки пользователем. Стоимость приобретения и вознаграждение разработчика различаются; условия получения вознаграждения и доступность Fragment проверяйте по действующим правилам Telegram. Не обещайте фиксированную рублёвую сумму без расчёта.

До запуска определите, куда покупатель обращается с ошибкой оплаты, недоставленным материалом и возвратом. Правила Telegram возлагают обработку споров на разработчика. Условия покупки и способ связи должны быть доступны до оплаты.

Пример внешнего сценария: читатель видит публикацию с описанием гайда, открывает страницу продукта в браузере, проверяет состав и цену и оформляет заказ на сайте. При ЮKassa доступ появляется после подтверждения платежа; при ручном СБП — после проверки перевода автором.

В этом сценарии Витрина выдаёт доступ на сайте и отправляет письмо на email заказа. Покупатель может восстановить доступ через «Мои покупки». Это не обещание автоматической отправки PDF сообщением Telegram.

Для цифровой покупки внутри собственного бота не заменяйте Stars внешним платёжным провайдером ради обхода требований. Если выбранный формат вызывает сомнения, сверяйтесь с документацией Telegram до разработки и публикации.

Проверьте успешную оплату, отказ, повторное событие, недоставленный материал и возврат. Для бота Telegram предусмотрена тестовая среда; для страницы Витрины отдельно проверяются оформление, подтверждение платежа, выдача и письмо. Один снимок формы не подтверждает работу всей цепочки.

Выбирайте путь по месту покупки и дальнейшему обслуживанию: встроенный бот требует своей интеграции Stars, страница Витрины — настройки магазина автора или ручного СБП. Сравнивайте стоимость, поддержку, возвраты и восстановление доступа, а не только удобство первой кнопки.