Telegram Stars

Покупатель платит звёздами Telegram (Telegram Stars) прямо в чате с ботом проекта, без перехода на страницу оплаты. Звёзды приходят на баланс бота проекта. Вывести их может владелец бота через Fragment: через эту площадку Telegram выплачивает вознаграждение за звёзды. Оплату подтверждает Telegram, после этого бот выдаёт покупателю доступ к каналу или группе. У провайдера ничего подключать не нужно: в Mini App вы задаёте только курс, сколько рублей цены тарифа стоит одна звезда.

Кому подходитСкопировать ссылку на раздел

• В Mini App способ помечен «Физ. / Юр. лица»: договор с провайдером платежей не нужен.
• Покупатель платит звёздами Telegram. Число звёзд Vanderu считает из цены тарифа в рублях по вашему курсу, а с промокодом из цены со скидкой.
• Автопродления нет: за каждый срок подписки покупатель платит сам.

Сравнить с другими способами: сравнительная таблица платёжных систем.

Что нужно заранееСкопировать ссылку на раздел

Для шагов ниже:

• Проект в Vanderu с ботом: как создать проект. Пока проекта нет, на главном экране Mini App нет раздела «Настройки».
• Доступ к аккаунту Telegram, который владеет ботом проекта в @BotFather. Только этот аккаунт выведет звёзды.

Чтобы покупатель увидел способ в боте: канал или группа (канал, группа) и платный тариф проекта (как создать тариф).

Подключите Telegram Stars в Mini AppСкопировать ссылку на раздел

1. Откройте Mini App из чата с @vanderu_bot и прокрутите главный экран вниз. В разделе «Настройки» нажмите «Платежные системы». Откроется экран «Выберите платежную систему».

2. Нажмите «Telegram Stars». Откроется экран «Подключение Telegram Stars» с разделами «Что понадобится» и «Настройки».

   Покупатель платит столько звёзд, сколько получится по вашему курсу. Если ошибиться, доступ уйдёт дешевле: например, при курсе 100 вместо 1,00 тариф за 500 ₽ стоит 5 звёзд вместо 500.

3. В единственном поле формы укажите курс: сколько рублей цены тарифа стоит одна звезда. Поле подписано «Сколько рублей стоит 1» со значком звезды. Курс от 0,10 до 100, до двух знаков после запятой. Vanderu делит цену тарифа на курс и округляет вверх: например, при курсе 1,50 тариф за 500 ₽ стоит 334 звезды. В разделе «Настройки» над полем Mini App подсказывает, сколько примерно стоит звезда покупателю и сколько получите вы при выводе.

   

4. Внизу экрана нажмите «Сохранить». Mini App покажет «Настройки сохранены, способ оплаты подключён» и откроет экран «Детали Telegram Stars» со статусом «Принимает оплату».

5. Проверьте текст «Обращение в поддержку»: его бот пришлёт покупателю на команду /paysupport. Вернитесь на главный экран, откройте проект и нажмите «Сообщения бота», затем «Обращение в поддержку». У проекта там уже стоит текст по умолчанию «Если нужна помощь пиши сюда:», после которого бот подставит ваше имя пользователя Telegram через @. Если покупатели должны писать не туда, напишите в поле «Текст сообщения», как с вами связаться, и нажмите «Сохранить». Текст свой у каждого проекта.

Telegram Stars сразу появляется у покупателей во всех ваших проектах, в том числе в новых. Чтобы оставить его только в некоторых проектах, на экране «Детали Telegram Stars» нажмите «Проекты».

Как покупатель платитСкопировать ссылку на раздел

1. Покупатель выбирает в боте проекта тариф и нажимает «Telegram Stars».
2. Бот присылает сумму к оплате в звёздах, цену тарифа в рублях, тариф и срок, под сообщением кнопки «Оплатить» и «Отменить платеж».
3. «Оплатить» открывает окно оплаты звёздами в Telegram. Счёт можно оплатить в течение 22 часов. После «Отменить платеж» этот счёт оплатить уже нельзя.
4. Telegram сообщает боту проекта об оплате, и бот выдаёт доступ.

Telegram требует, чтобы бот, который принимает звёзды, отвечал на команду /paysupport (правила Telegram для разработчиков ботов), а условия покупки советует показывать по команде /terms (документация Telegram о платежах звёздами). Боты проектов отвечают на обе команды сами: на /paysupport текстом «Обращение в поддержку» из шага 5, на /terms условиями покупки, одинаковыми для всех проектов. Изменить условия нельзя.

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

Текст сообщения со ссылкой меняется в Mini App: на экране проекта нажмите «Сообщения бота», затем «После покупки». Ссылка стоит в тексте там, где написано {link}, а дата окончания подписки — там, где {date}. Если убрать их из текста, покупатель не получит ссылку или дату.

Как проверитьСкопировать ссылку на раздел

Вернитесь на экран «Выберите платежную систему»: у карточки «Telegram Stars» стоит метка «Подключено».

Проверьте без оплаты:

1. Откройте бота своего проекта и нажмите «Тарифы».
2. Если бот попросит «Выбери ресурс», выберите канал. Затем выберите тариф.
3. Нажмите «Telegram Stars».
4. Если бот прислал сообщение с кнопкой «Оплатить», способ работает. Сверьте число звёзд в сообщении с вашим курсом.
5. Нажмите «Отменить платеж».
6. Отправьте боту /paysupport. Бот пришлёт текст «Обращение в поддержку» этого проекта. Если бот ответил «По вопросам оплаты напишите владельцу бота.», у проекта нет этого текста: напишите его, как в шаге 5 раздела «Подключите Telegram Stars в Mini App».

На экране «Детали Telegram Stars» эта оплата появится в списке «Платежи» со статусом «Отменено».

После первой настоящей оплаты она появится в этом списке со статусом «Оплачено», числом звёзд и суммой в рублях, а @vanderu_bot пришлёт вам «Новая продажа» со способом оплаты Telegram Stars и числом звёзд.

Как вывести звёздыСкопировать ссылку на раздел

Звёзды каждой оплаты приходят на баланс бота того проекта, где покупатель платил. Mini App баланс звёзд не показывает. Вывод делает владелец бота в Telegram, Vanderu в нём не участвует. Условия задаёт Telegram, они описаны в правилах для разработчиков ботов (разделы 6.2.4, 6.2.6 и 6.2.7) и в документации Telegram о звёздах:

• Вывести звёзды может только владелец бота. Telegram открывает страницу Fragment, где указывается адрес кошелька TON для вывода. Для вывода нужен облачный пароль в аккаунте владельца бота.
• Вывод доступен, когда на балансе бота набралось минимальное число звёзд, которое задаёт Telegram.
• Полученные звёзды могут быть недоступны для вывода до 21 дня.
• Звёзды действуют 3 года с даты получения. Если за это время их не вывести и не потратить на рекламу в Telegram, Telegram их спишет.
• Если включить боту темы в личных чатах в @BotFather, Telegram удерживает 15 % с каждой покупки звёздами, пока темы включены.

Изменить, отключить или удалить Telegram StarsСкопировать ссылку на раздел

На главном экране Mini App в разделе «Настройки» нажмите «Платежные системы», затем «Telegram Stars». Откроется экран «Детали Telegram Stars».

• Чтобы изменить курс, нажмите «Изменить настройки». Откроется форма «Настройки Telegram Stars» с текущим курсом. Исправьте его и нажмите «Сохранить». Новый курс действует для новых счетов, в уже выставленных число звёзд не меняется.
• Чтобы оставить Telegram Stars только в некоторых проектах, нажмите «Проекты», выключите лишние проекты и нажмите «Сохранить».

• Чтобы скрыть Telegram Stars от покупателей во всех проектах, нажмите «Отключить» и подтвердите. Вернуть способ можно кнопкой «Включить».

Чтобы удалить Telegram Stars, нажмите «Удалить», а затем в течение 5 секунд «Нажмите ещё раз, чтобы удалить». Mini App покажет «Способ оплаты удалён». Курс сотрётся, звёзды на балансе ботов останутся. Подключить способ снова можно теми же шагами, что и в первый раз.

Если не получилосьСкопировать ссылку на раздел

В боте нет кнопки «Telegram Stars»Скопировать ссылку на раздел

Проверьте по порядку:

• Тариф дороже 10 000 звёзд по вашему курсу. Такой счёт Vanderu не выставляет: например, при курсе 1,50 кнопки нет у тарифов дороже 15 000 ₽. Чтобы продавать такой тариф за звёзды, поднимите курс. Курс один для всех тарифов и проектов: все они станут стоить меньше звёзд.
• Тариф бесплатный или пробный: кнопки «Telegram Stars» у таких тарифов не бывает.
• Telegram Stars отключён или выключен для этого проекта в «Проекты» на экране «Детали Telegram Stars».

Покупатель пишет, что Telegram не принял оплатуСкопировать ссылку на раздел

Telegram показывает покупателю причину:

• «Счёт больше не действует. Откройте «Тарифы» и создайте новый»: прошло больше 22 часов или покупатель нажал «Отменить платеж». Пусть выберет тариф заново.
• «Этот счёт не подходит для оплаты. Откройте «Тарифы» и создайте новый»: счёт открыл не тот, для кого бот его выставил, например покупатель переслал его другому человеку. Пусть оплачивающий сам выберет тариф в боте.
• «Оплата звёздами сейчас недоступна. Выберите другой способ»: вы отключили Telegram Stars или выключили его для этого проекта.
• «Этот счёт уже оплачен»: доступ по этому счёту уже выдан.
• «Не удалось проверить оплату, попробуйте ещё раз»: Vanderu не успел ответить Telegram. Звёзды не списаны, пусть покупатель нажмёт «Оплатить» ещё раз.

Бот пишет «Ошибка создания платежа. Попробуйте еще раз.»Скопировать ссылку на раздел

Telegram не создал счёт в звёздах. Пусть покупатель попробует через минуту. Если ошибка повторяется, проверьте, что бот проекта работает: в Mini App на экране проекта нет сообщения «Бот не работает».

Покупатель пишет, что при создании ссылки произошла ошибкаСкопировать ссылку на раздел

Оплата прошла, подписка записана, но @vanderu_bot не смог создать ссылку на вход, например потому, что у него нет прав администратора в канале. Верните ему права, чтобы это не повторилось: для канала, для группы. Этому покупателю бот ссылку повторно не пришлёт: напишите в поддержку @vanderusupport_bot и назовите проект, дату, сумму и число звёзд из списка «Платежи» на экране «Детали Telegram Stars».

Если не помоглоСкопировать ссылку на раздел

Напишите в поддержку: @vanderusupport_bot.

ОграниченияСкопировать ссылку на раздел

• Курс от 0,10 до 100, до двух знаков после запятой. Число звёзд округляется вверх, меньше одной звезды счёт не бывает.
• Один счёт не больше 10 000 звёзд. Тариф, которому по вашему курсу нужно больше, кнопки «Telegram Stars» не получает.
• Счёт можно оплатить в течение 22 часов.
• Если тариф проекта бесплатный, способов оплаты у него нет: покупатель получает доступ кнопкой «Получить». Пробный тариф проекта (от 3 до 30 дней по цене ниже тарифа продления, затем автопродление) оплачивается только через ЮKassa с автопродлением, Telegram Stars у него не показывается.
• Вернуть звёзды покупателю из Mini App нельзя. Если покупатель оплатит один счёт дважды, вторую оплату Vanderu попробует вернуть ему сам. Если возврат не прошёл, напишите в поддержку @vanderusupport_bot.
• Если Telegram вернёт звёзды покупателю, например по его жалобе, доступ к каналу Vanderu не отзывает, а звёзды Telegram спишет с баланса бота.
• Сколько вы получите за звёзды при выводе, решает Telegram: правила Telegram для разработчиков ботов, раздел 6.2.4.
• Сколько вы платите Vanderu: тарифы Vanderu.