Платежи
Справочник по вкладке Настройки → Платежи: способы оплаты и выбор провайдера, ключи YooKassa, Platega, CryptoBot и Telegram Stars, автопродление по СБП и магазин Stars и Premium через Reefox.
Во вкладке Настройки → Платежи четыре части: «Способы оплаты», «Подключения», «Автопродление» и «Stars и Premium». Где взять ключи в кабинетах провайдеров и как провести проверочную оплату — на странице Приём оплаты.
Что сохраняется вместе
«Способы оплаты» и «Подключения» сохраняет одна кнопка «Сохранить платежи». «Автопродление» и «Stars и Premium» сохраняются своими кнопками.
Способы оплаты
Таблица «Оплата для клиентов» показывает каждый способ оплаты, кто его обслуживает и виден ли он клиентам.
| Колонка | Что значит |
|---|---|
| Способ оплаты | СБП, Банковская карта, CryptoBot, Криптовалюта, Международная карта, ЕРИП, Telegram Stars |
| Провайдер | Кто проводит платёж. Для СБП и карты можно выбрать, если подключены и YooKassa, и Platega |
| Резерв | Второй провайдер для СБП или карты |
| Статус | Включён — клиенты видят способ. Скрыт — провайдер не подключён или выключен |
- СБП и банковская карта доступны на сайте и в Telegram. Telegram Stars — только в Mini App.
- Способ считается подключённым, только если провайдер включён и у него заполнены ключи. Карта у Platega появляется, если в её настройках отмечена «Карта РФ», СБП — если отмечен «СБП».
- Статус показывает только настройки. Работают ли ключи на самом деле, проверяется у провайдера.
Резерв не срабатывает при ошибках
Резервный провайдер используется, только если основной выключен или не настроен. Если основной включён, но отвечает ошибкой, платёж на резерв сам не уйдёт.
Подключения
Список провайдеров. У каждого справа переключатель «Включить …» и статус: Включён, Нужны настройки (включён, но ключи не заполнены) или Выключен. Нажмите на строку, чтобы раскрыть поля.
Под каждым провайдером, кроме Stars, есть «Адрес уведомлений» вида https://ваш-домен/api/webhooks/yookassa и кнопка «Копировать». Этот адрес вставляется в кабинет провайдера.
YooKassa
| Поле | Что вводить |
|---|---|
| Shop ID | Номер магазина из кабинета YooKassa |
| Секретный ключ | Ключ API из кабинета YooKassa. Скрыт точками, глазок показывает его |
| Email для чеков | Адрес, который попадает в чек к платежу, например receipts@example.com |
Адрес уведомлений вставляется в YooKassa → HTTP-уведомления.
Platega
| Поле | Что вводить |
|---|---|
| Merchant ID | ID мерчанта из кабинета Platega |
| Секретный ключ | Секретный ключ из кабинета Platega |
| Способы оплаты | Галочки: СБП, Карта РФ, Международная карта, Криптовалюта, ЕРИП. Отмечайте только то, что вам включил менеджер Platega. Хотя бы один способ должен остаться |
Адрес уведомлений вставляется в Platega как Callback URL.
CryptoBot
| Поле | Что вводить |
|---|---|
| API token | Токен приложения из @CryptoBot → Crypto Pay |
Адрес уведомлений вставляется в @CryptoBot: My Apps → ваше приложение → Webhooks. Минимальная сумма счёта — 10 ₽.
Telegram Stars
| Поле | Что вводить |
|---|---|
| Стоимость одной звезды, ₽ | Курс, по которому цена в рублях пересчитывается в звёзды. По умолчанию 2.5. Только цифры и точка |
Под полем видно итоговое правило, например «1 Star = 2.5 ₽». Адрес уведомлений не нужен: оплату принимает ваш бот, поэтому он должен работать.
Ключи не стираются пустым полем
Если очистить поле с секретным ключом или токеном и сохранить, сервер оставит прежнее значение. Чтобы перестать принимать оплату через провайдера, выключите его переключатель.
Автопродление
Ежемесячное автоматическое списание по СБП через YooKassa или Platega. Пока ни один из них не включён с сохранёнными ключами, вкладка показывает «Сначала подключите платёжного провайдера» и кнопку «Открыть подключения».
Блок «СБП-автопродление»
Карточка на каждого подключённого провайдера. Если подключены оба, у каждого есть галочка: через кого предлагать автопродление.
| Статус провайдера | Что значит и что нажать |
|---|---|
| Ожидает допуска | Менеджер провайдера ещё не включил автосписания. Когда включит, нажмите «Провайдер разрешил автосписания» |
| Готов к тесту | Нажмите «Создать счёт на 10 ₽» и оплатите его через СБП |
| Проверено | Тестовый платёж прошёл, автопродление можно показывать клиентам |
| Тест отклонён | Провайдер не разрешил сохранить СБП-счёт. Ниже будет причина |
Во время теста доступны «Продолжить оплату», «Открыть счёт» и «Проверить статус». Статус обновляется сам каждые несколько секунд. После успешного теста кнопка меняется на «Проверить ещё раз за 10 ₽». «Сбросить допуск» возвращает провайдера в «Ожидает допуска».
Если подключены оба провайдера, у одного стоит метка «Основной после проверки», у другого — кнопка «Сделать основным».
Тестовый платёж настоящий
10 ₽ списываются реально и приходят в ваш же магазин. Тест не создаёт подписку клиенту.
Остальные поля
| Поле | Что значит |
|---|---|
| Показывать автопродление клиентам | Включается только после успешного теста. Клиент сможет подключить продление при оплате через СБП и отключить его в профиле |
| Повторные попытки списания | Свёрнутый блок. Дни после неудачного списания — через сколько дней пробовать снова, через запятую. По умолчанию 1, 3, 7. До пяти разных дней от 1 до 14, по возрастанию |
Нажмите «Сохранить автопродление».
Выключить автопродление при живых подписках нельзя
Если у клиентов есть действующие автоподписки, сервер не сохранит выключение: «Сначала отключите действующие автоподписки». Выключение в админке не отменяет списания у провайдера.
Stars и Premium
Магазин Telegram Stars и Telegram Premium за рубли. Выдачу делает сервис Reefox (reefox.ru). Других поставщиков нет. Для продажи VPN магазин не нужен.
Подключение
| Поле или кнопка | Что делать |
|---|---|
| API-токен Reefox | Вставьте токен sk_live_… из кабинета на reefox.ru. Токен показывается там один раз; если потеряли — выпустите новый |
| «Подключить» | Сервер проверит токен, сохранит его и включит магазин |
| «Кабинет Reefox» | Открывает кабинет: токены, пополнение баланса, заказы |
Тестовый токен не открывает магазин
Токен sk_test_… подключается, но настоящим клиентам магазин не откроется: статус будет «Закрыт» с подсказкой, что нужен боевой токен.
Когда Reefox подключён
- Продавать Stars и Premium — главный переключатель. Статус справа: «Открыт для клиентов» или «Закрыт» с причиной.
- Сводка: режим токена (Боевой токен или Тестовый токен), Баланс в TON и сколько в резерве, курс TON — рыночный или заданный вручную.
- Если баланс меньше 1 TON, появится предупреждение: заказы будут ждать пополнения.
- Кнопки: «Обновить», «Сменить токен», «Отключить». После отключения магазин закрывается, а оплаченные, но не выданные заказы ждут, пока вы подключите Reefox снова.
Розничные цены
Цены для клиентов в рублях: Stars — 100, 250, 500 и 1000 штук, Premium — на 3, 6 и 12 месяцев. Количества фиксированы, меняются только цены.
Курс и минимальная прибыль
| Поле | Что значит | По умолчанию |
|---|---|---|
| Курс TON, ₽ (пусто — рыночный) | Свой курс TON в рублях. Пусто — сервер берёт рыночный | пусто |
| Валютный запас, % | Насколько закладывать рост курса | 3 |
| Минимальная прибыль, % | Ниже этой прибыли заказ не оформится | 8 |
В расчёт также заложено 7 % дополнительных расходов. Курс — от 1 до 100 000 ₽. Запас — от 0 до 30 %, прибыль — от 0 до 50 %: значения вне этих рамок форма сохранит, но заказы перестанут оформляться. Если закупочная цена Reefox выросла и прибыль ниже порога, клиент увидит «Продажа временно остановлена» и деньги не спишутся.
Нажмите «Сохранить магазин».
Последние заказы
Список последних заказов: получатель, товар, сумма и статус — Ожидает оплату, Оплачен, Выдаётся, Доставлен, Частично, Ошибка, Отменён, Возвращён. Под проблемным заказом видна причина. Нехватка TON у вас или у Reefox не требует действий: заказ выдастся сам после пополнения. Если Reefox отказал в выдаче, деньги клиенту нужно вернуть вручную.