Функционал

Методы оплат

Подключение платёжных систем и настройка тарифных планов. Все параметры задаются в веб-админке — Настройки > Основные > Методы оплаты.

Настройка платёжных шлюзов

💡
Все ключи и переключатели методов оплаты настраиваются в одном месте: Веб-админка > Настройки > Основные > Методы оплаты.

YooKassa

  • 1Зарегистрируйте магазин в YooKassa и получите Shop ID и Secret Key в личном кабинете.
  • 2В личном кабинете YooKassa перейдите в Настройки > HTTP Уведомления и добавьте URL вебхука:
    Webhook URL
    https://домен-бота.ru/yookassa/webhook
    Рекомендуется включить все типы уведомлений.
  • 3В веб-админке заполните:
    yookassa_shop_id — ID магазина
    yookassa_secret_key — секретный ключ
  • 4Включите переключатель «Показывать метод оплаты YooKassa» и сохраните.

Platega

  • 1Зарегистрируйтесь на сайте Platega и свяжитесь с персональным менеджером для получения:
    platega_merchant_id — ID мерчанта
    platega_api_secret — секретный ключ API
  • 2Добавьте Callback URL в личном кабинете Platega:
    Callback URL
    https://домен-бота.ru/platega/callback
  • 3Заполните ключи в веб-админке и настройте доступные методы оплаты в поле platega_enabled_methods.
  • 4Включите переключатель «Показывать метод оплаты Platega» и сохраните.
platega_enabled_methods — доступные коды методов
2
СБП
10
Карты RUB
11
Карточный эквайринг
12
Международный эквайринг
13
Криптовалюта
Примеры значений поля
JSON
// Только СБП
[2]

// СБП и карты RUB
[2, 10]

// СБП, карточный эквайринг и крипта
[2, 11, 13]
⚠️
Изменение набора методов выполняется через персонального менеджера Platega. Если нужен новый метод — напишите ему. Самостоятельно в личном кабинете это изменить нельзя.

Telegram Stars

Не требует настройки ключей API. Платежи списываются звёздами Telegram с баланса пользователя — поступления идут на баланс вашего бота (доступны к выводу в TON через Fragment).

  • 1Включите переключатель «Показывать метод оплаты TG Stars» в настройках.
  • 2Сохраните — готово.

CryptoBot

  • 1Откройте @CryptoBot > Crypto Pay > Создать приложение > получите API Token.
  • 2В веб-админке укажите cryptobot_token.
  • 3Включите переключатель «Показывать метод оплаты CryptoBot» и сохраните.
💡
Счета создаются ботом автоматически. Статус проверяется в фоне и дополнительно по кнопке «Проверить платёж».

YooMoney

Поддерживает P2P-платежи и оплату картой. Требует OAuth-токен и настройку HTTP-уведомлений.

⚠️
Настройка YooMoney сложнее других методов и требует дополнительного изучения документации YooMoney.
  • 1Создайте OAuth-приложение на yoomoney.ru.
  • 2Авторизуйтесь по ссылке (в браузере) и получите code из адресной строки:
    URL
    https://yoomoney.ru/oauth/authorize?client_id=CLIENT_ID&response_type=code&redirect_uri=REDIRECT_URI&scope=account-info+operation-history+operation-details+payment-shop
  • 3Обменяйте code на токен (выполнять в cmd.exe, не PowerShell):
    cmd
    curl -X POST https://yoomoney.ru/oauth/token ^
      -H "Content-Type: application/x-www-form-urlencoded" ^
      -d "code=ВАШ_CODE&client_id=ВАШ_CLIENT_ID&grant_type=authorization_code&redirect_uri=ВАШ_REDIRECT_URI"
    В ответе будет access_token — это и есть yoomoney_token.
  • 4В веб-админке заполните:
    yoomoney_token — OAuth-токен
    yoomoney_account — номер кошелька YooMoney
    yoomoney_notification_secret — секрет для верификации
  • 5Настройте HTTP-уведомления на yoomoney.ru: включите «Отправлять HTTP-уведомления» и укажите URL https://домен-бота.ru/yoomoney/.
  • 6Включите переключатель «Показывать метод оплаты YooMoney» и сохраните.

Тарифы

💡
Тарифы настраиваются в веб-админке — раздел Тарифы в боковом меню. Рекомендуется добавлять тарифы через «Линейку тарифов» — это позволяет удобно управлять несколькими предложениями одновременно и быстро переключать активный набор.

Параметры тарифа

Название
Отображается пользователю в боте при выборе тарифа. Например: «1 месяц», «3 месяца».
Цена (руб.)
Стоимость тарифа. Указывается в рублях для всех шлюзов, кроме Telegram Stars (там указываются звёзды).
Дней подписки
Количество дней, которые добавляются к подписке при успешной оплате.
Лимит устройств
Максимальное количество одновременных подключений (используется как limit_ip в 3X-UI / Remnawave). 0 = без лимита.
Трафик (GB)
Лимит трафика для тарифов с Remnawave. 0 = безлимит.
Звёзды TG
Стоимость в Telegram Stars, если используется метод оплаты TG Stars. Заполняется отдельно от рублёвой цены.

Линейка тарифов

Линейка тарифов — это именованный набор тарифных планов, который можно быстро активировать целиком. Удобно, если вы хотите предлагать разные комбинации (например, базовый и премиум набор) и переключаться между ними.

  • 1В разделе Тарифы нажмите «Создать линейку» и задайте ей название.
  • 2Добавьте тарифы в линейку: задайте название, цену, дни, лимит устройств и при необходимости трафик.
  • 3Активируйте нужную линейку — все тарифы из неё станут доступны пользователям в боте.
Рекомендуется использовать линейку тарифов даже при одном наборе — это упрощает управление и позволяет легко менять предложения в будущем.

Пример линейки

Базовая линейка — 3 тарифа
1 месяц
Цена: 199 ₽
Дней: 30
Устройств: 3
3 месяца
Цена: 499 ₽
Дней: 90
Устройств: 3
1 год
Цена: 1490 ₽
Дней: 365
Устройств: 3