Магазин Stars и Premium через Reefox
Как с нуля завести кабинет на reefox.ru, купить и внести TON, выпустить API-ключ и открыть в Reefox Panel магазин Telegram Stars и Premium.
Магазин Stars и Premium — дополнительный товар в кабинете ваших клиентов: они покупают Telegram Stars и Telegram Premium за рубли. Выдаёт заказы сервис Reefox (reefox.ru), других поставщиков нет. Для продажи VPN магазин не нужен — подключайте его, если хотите дополнительный доход.
Справочник по вкладке админки — Настройки → Платежи → Stars и Premium. Описание API для разработчиков — Reefox Stars API.
Как идут деньги
Вы заранее пополняете баланс в кабинете Reefox криптовалютой TON.
Клиент выбирает в кабинете Stars или Premium, вводит username получателя и платит рублями любым вашим способом: СБП, картой и т. д. Оплата звёздами в магазине не предлагается.
После оплаты Reefox Panel отправляет заказ в Reefox, Reefox списывает его стоимость в TON с вашего баланса и выдаёт Stars или Premium получателю.
Ваш доход — разница между розничной ценой в рублях и закупочной ценой в TON. Reefox Panel сверяет её при каждом заказе и не даст продать в минус.
Что понадобится
- Аккаунт Telegram — через него вы входите в кабинет Reefox.
- Подключённый приём оплаты в Reefox Panel — см. Приём оплаты. Без него клиенту нечем платить.
- Несколько TON на баланс. Как купить — в шаге 2.
- 20–40 минут, плюс время на покупку TON.
Шаг 1. Войдите в кабинет Reefox
Отдельной регистрации нет: кабинет создаётся при первом входе через Telegram.
Откройте reefox.ru/cabinet. В Reefox Panel туда же ведёт кнопка «Кабинет Reefox» на вкладке Stars и Premium.
Нажмите «Продолжить через Telegram» и подтвердите вход в окне Telegram.
Откроется кабинет партнёра. Слева разделы «Обзор», «Заказы», «Баланс» и «API», внизу — ваше имя и режим Mainnet.
Шаг 2. Купите TON
TON — криптовалюта сети TON, на ней работают платежи Telegram. Купить её можно несколькими способами:
- Кошелёк в Telegram (@wallet). Откройте бота @wallet, нажмите «Start», затем P2P Маркет → Купить, выберите TON и рубли. Продавцы — другие пользователи, оплата картой российского банка. Удобно для небольших сумм.
- Некастодиальный кошелёк Tonkeeper — приложение для телефона и компьютера. В нём можно получить TON и отправить с комментарием.
- Криптобиржа, которая поддерживает вывод TON в сети TON с комментарием (memo).
Условия покупки, комиссии и проверка личности зависят от выбранного сервиса и вашей страны — смотрите их правила.
Нужен перевод с комментарием
Reefox зачисляет TON на ваш баланс автоматически только по комментарию к переводу. Перед покупкой убедитесь, что ваш кошелёк или биржа умеет отправлять TON в сети TON с комментарием. Перевод без комментария сам не зачислится.
Шаг 3. Пополните баланс Reefox
В кабинете откройте «Баланс». Справа в блоке «Условия» указаны сеть TON Mainnet и минимальная сумма пополнения.
Нажмите «Пополнить баланс». Выберите 5, 10 или 25 TON или введите «Другая сумма».
Кабинет создаст счёт: QR-код, «Точная сумма», «Адрес в сети TON» и «Комментарий · обязателен». Каждое поле копируется нажатием.
Отправьте перевод из кошелька. Проще всего отсканировать QR-код — сумма, адрес и комментарий подставятся сами. Если вводите вручную, вставьте адрес, точную сумму и комментарий без изменений. При выводе с биржи выберите сеть TON.
Не закрывайте окно: статус «Ожидаем перевод» сменится на «Оплата зачислена», как только сеть подтвердит перевод. Обычно это минуты. Баланс на «Обзоре» обновится сам.
Сколько держать на балансе — зависит от продаж. Reefox Panel предупредит, когда на балансе останется меньше 1 TON. Если TON не хватит, оплаченные заказы не пропадут: они подождут и выдадутся сами после пополнения.
Шаг 4. Выпустите API-ключ
В кабинете откройте «API» и нажмите «Создать ключ».
В окне нажмите «Создать API-ключ». Ключ вида sk_live_… покажется один раз.
Нажмите «Скопировать ключ» и сразу вставьте его в Reefox Panel (шаг 5) или сохраните в менеджере паролей.
У кабинета только один активный ключ. Если ключ потерян, нажмите «Управлять ключом» → «Перегенерировать ключ»: новый ключ сразу отзовёт старый, и магазин в Reefox Panel перестанет работать, пока вы не вставите новый.
Ключ — только в админке
С ключом можно тратить ваш TON-баланс. Не пересылайте его в чатах и не публикуйте на скриншотах. Если ключ мог утечь — перегенерируйте его и замените в Reefox Panel.
Шаг 5. Подключите Reefox в Reefox Panel
Откройте Настройки → Платежи → Stars и Premium.
Вставьте ключ в поле «API-токен Reefox» и нажмите «Подключить».
Reefox Panel проверит ключ запросом баланса и сама включит магазин. Появится «Reefox подключён, магазин открыт», справа статус «Открыт для клиентов», в сводке — Боевой токен, Баланс в TON и курс TON.
Проверьте «Розничные цены» для Stars (100, 250, 500, 1000) и Premium (3, 6, 12 месяцев). При необходимости раскройте «Курс и минимальная прибыль» и нажмите «Сохранить магазин».
Что значит каждое поле цен и курса — в справочнике.
Тестовый ключ sk_test_
Кабинет на reefox.ru выдаёт боевые ключи sk_live_…. Ключ sk_test_… Reefox Panel тоже примет, но магазин для клиентов останется «Закрыт»: «Подключён тестовый токен Reefox. Для продаж нужен боевой (sk_live_…)». Тестовые заказы ничего не выдают, а деньги с клиента списались бы по-настоящему.
Проверка
- В админке у магазина статус «Открыт для клиентов» и виден баланс TON.
- В кабинете клиента (Mini App и сайт) раздел «Магазин» показывает Stars и Premium с вашими ценами.
- Пробная покупка: купите 100 Stars на свой username своим же способом оплаты. Это настоящая оплата: деньги придут к вам через платёжного провайдера, TON спишется с баланса Reefox. В админке в «Последних заказах» статус дойдёт до «Доставлен», а в кабинете Reefox заказ появится в «Заказах».
Частые ошибки
| Что видите | Причина | Что сделать |
|---|---|---|
| «Это не похоже на API-токен Reefox. Он начинается с sk_live_ или sk_test_» | Скопирован не ключ или не целиком | Скопируйте ключ заново; если окно закрыто — перегенерируйте |
| «Reefox не принял токен. Проверь, что скопирован весь ключ и что он не был перевыпущен.» | Ключ перегенерирован или с ошибкой | Вставьте актуальный ключ через «Сменить токен» |
| «Reefox не отвечает по адресу …» | Сервер Reefox Panel не достучался до reefox.ru | Проверьте исходящий HTTPS с сервера, повторите позже |
| «Баланс Reefox меньше 1 TON — пополни в кабинете Reefox, иначе заказы будут ждать.» | Заканчивается TON | Пополните баланс (шаг 3) |
| Перевод отправлен, а баланс не вырос | Нет комментария, другой комментарий или не та сеть | Проверьте перевод в кошельке; без комментария обратитесь в поддержку Reefox с хешем транзакции |
| Клиент видит «Продажа временно остановлена» | Закупочная цена выросла, прибыль ниже порога | Поднимите розничные цены или снизьте «Минимальная прибыль, %» |
| Клиент не может ввести получателя | У получателя нет username | Нужен username Telegram: 5–32 латинских символа, цифр или подчёркиваний |
| В заказе «Токен Reefox перестал подходить — подключи заново» | Ключ перегенерирован в кабинете | Вставьте новый ключ через «Сменить токен» |
| В заказе «Reefox не смог выдать заказ — нужен возврат клиенту» | Reefox отказал в выдаче | Верните клиенту деньги через платёжного провайдера |
Нехватка TON у вас («У Reefox не хватает TON — пополни баланс, заказ выдастся сам») или у самого Reefox не требует возврата: заказ выдастся после пополнения.