Руководство по плагину Telegram Premium
Telegram Premium продаёт подписку Telegram Premium на 3, 6 и 12 месяцев без вашего участия. Покупатель оплачивает лот — бот берёт его @username из параметров заказа или спрашивает в чате, проверяет ник на Fragment, оплачивает подарок с вашего TON-кошелька и сообщает покупателю, что подписка подарена. Срок подписки бот узнаёт по метке в лоте, поэтому 3, 6 и 12 месяцев не перепутаются. Кошелёк и доступ к Fragment общие с плагином Auto Stars — настраивать второй раз не нужно.
🎯 Для чего это нужно
- Продажи круглые сутки: подписка выдаётся за пару минут, даже когда вы спите.
- Без ошибок в нике: бот проверяет ник на Fragment до оплаты и просит прислать заново, если такого нет.
- Деньги не уходят дважды: один заказ оплачивается один раз — даже после сбоя.
✨ Что умеет плагин
- Подписки на 3, 6 и 12 месяцев: срок — по метке #premium:3, #premium:6 или #premium:12 в названии или описании лота.
- Ник покупателя: из параметров заказа, иначе бот спрашивает в чате; понимает @ник, t.me/ник и просто ник.
- Проверка на Fragment: до оплаты; трижды прислали несуществующий ник — заказ передаётся вам.
- Проверка баланса: TON не хватает — бот не платит, пишет покупателю, что Premium придёт чуть позже, а вам — сколько нужно.
- Проверка возврата: заказ уже возвращён — подарок не оплачивается.
- Защита от двойной оплаты: отметка ставится до перевода; после сбоя бот не платит повторно, а пишет вам.
- Автоцены: цена лота = цена подписки на Fragment в $ × курс доллара × (1 + наценка), пересчёт раз в 30 минут.
- Статистика: сколько подписок продано и на сколько TON.
⚡ Быстрый старт
- Включите плагин и перезапустите бота (шаг 1 ниже).
- Настройте кошелёк и Fragment в плагине Auto Stars.
- Добавьте метку #premium:3 (6 или 12) в лоты.
- /premium → «▶️ Включить».
🛠️ Пошаговая настройка
ШАГ 1. Включите плагин (обязательно перед настройкой)
- Отправьте своему боту команду /menu.
- Откройте 🔧 Система и Конфиги → 🧩 Плагины и найдите Telegram Premium.
- Нажмите «Включить».
- ‼️ Перезапустите бота командой /restart — без перезапуска плагин не заработает.
ШАГ 2. Кошелёк и Fragment
- Откройте настройки плагина Auto Stars и заполните: ключ TonAPI, сид-фразу и адрес кошелька, hash и cookie Fragment.
- Пополните кошелёк TON — с него оплачиваются подписки.
💡 /premium покажет, чего не хватает: «👛 Кошелёк и Fragment (из Auto Stars): нет: ключ TonAPI, …». Пока всё не настроено, плагин не включится.
ШАГ 3. Лоты
- В название или описание лота добавьте метку срока: #premium:3, #premium:6 или #premium:12.
- Если в лоте есть поле для ника покупателя, бот возьмёт ник оттуда, иначе спросит в чате.
ШАГ 4. Запуск
- /premium (или «⚙️ Открыть настройки» в карточке плагина) — в строке «👛 Кошелёк и Fragment» должно быть «настроены».
- «💰 Баланс TON» — сколько TON на кошельке.
- Нажмите «▶️ Включить».
ШАГ 5. Автоцены (по желанию)
- «🔗 Лот в автоцены» → пришлите ID лота: срок бот возьмёт из метки #premium:N (или пришлите ID и срок: 12345678 6).
- «💹 Наценка» → 10 — наценка 10% к цене Fragment (по умолчанию 10%).
- Fragment поменял цену — «💲 Цена Fragment» → 3 11.99. По умолчанию: 3 мес. — 11.99 $, 6 мес. — 15.99 $, 12 мес. — 28.99 $.
- Нажмите «⚡ Автоцены: ❌» — станет ✅; «🔄 Обновить цены» — пересчитать сейчас. Убрать лот из автоцен — «🗑 Убрать лот».
🕹️ Меню и кнопки
Панель /premium
Сверху — включён ли плагин, настроены ли кошелёк и Fragment, сколько продано и в работе, автоцены и наценка; ниже — лоты с автоценой и цены Fragment.
- ▶️ Включить / ⏸ Выключить — принимать ли заказы с меткой #premium
- 💰 Баланс TON — баланс кошелька из Auto Stars
- ⚡ Автоцены: ✅ / ❌ — пересчитывать цены привязанных лотов раз в 30 минут
- 🔄 Обновить цены — пересчитать цены привязанных лотов прямо сейчас
- 🔗 Лот в автоцены — пришлите ID лота (и срок, если в лоте нет метки #premium:N)
- 🗑 Убрать лот — пришлите ID лота, который убрать из автоцен
- 💹 Наценка — наценка к цене Fragment в %
- 💲 Цена Fragment — срок и цена подписки на Fragment в $, например 3 11.99
- ⬅️ Назад — к карточке плагина
🔄 Как это работает
- Оплачен лот с меткой #premium — бот запоминает заказ и срок подписки.
- Ищет ник в параметрах заказа; нет — просит покупателя прислать @username.
- Проверяет ник на Fragment и получает счёт на оплату подарка.
- Проверяет баланс кошелька и что заказ не возвращён.
- Переводит TON на адрес Fragment и пишет покупателю, что Premium подарен.
- Вам — уведомление: ник, сумма в TON и хэш транзакции.
💬 Как это выглядит
Покупателю после оплаты
Спасибо за покупку! Пришлите @username аккаунта Telegram, которому подарить Premium на 3 мес.
Покупателю после подарка
✅ Telegram Premium на 3 мес. подарен @nickname. Он появится в течение пары минут.
Пожалуйста, подтвердите заказ 🙏
Вам в Telegram
✅ Premium 3 мес. → @nickname, 3.512 TON · #ABCD1234 · tx …
⌨️ Команды
/premium— панель плагина/premium_lot— привязать лот к автоценам: /premium_lot ID [срок]/premium_lot_del— отвязать лот/premium_markup— наценка в %/premium_usd— цена подписки на Fragment в $: /premium_usd 3 11.99
💡 Важно знать
- ⚠️ Держите на кошельке запас TON: при нехватке заказ ждёт, пока вы пополните кошелёк и выполните его вручную.
- Автоцены меняют цену, только если разница больше 1 ₽ — лишних сохранений лота нет.
- Курс доллара бот берёт из котировок TON на TonAPI.
❓ Частые вопросы
Что будет, если перевод TON не прошёл?
Бот не будет платить повторно, чтобы не списать деньги дважды. Он пришлёт уведомление: проверьте кошелёк и при необходимости выполните заказ вручную.
Нужен ли отдельный кошелёк?
Нет, используется тот же кошелёк, что в Auto Stars.
Откуда курс доллара?
Из котировок TON на TonAPI. Цена меняется, только если разница больше 1 ₽.
Покупатель прислал неправильный ник
Бот ответит «Не нашёл @ник на Fragment. Проверьте ник и пришлите ещё раз». После трёх неудачных попыток заказ передаётся вам.
Покупатель купил 2 подписки одним заказом
Бот подарит одну подписку на срок из метки лота — количество в заказе он не учитывает. Остальные выполните вручную или продавайте подписки по одной.
Покупатель прислал ник без @
Бот поймёт и так, если сообщение состоит только из ника. Ссылка t.me/ник тоже подойдёт.