Функционал

Методы оплат

Подключение платёжных систем и настройка тарифных планов. Ключи, переключатели и порядок кнопок — в веб-админке: Настройки → Основные → Методы оплаты. Полный URL webhook для каждого шлюза показывается на карточке провайдера (нужен заполненный connect_page_url в системных настройках).

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

💡
Где настраивать: Веб-админка → Настройки → Основные → Методы оплаты.
  • Порядок кнопок — перетащите способы оплаты в блоке «Предпросмотр» (настройка payment_methods_order). Один порядок для бота и личного кабинета на сайте.
  • Webhook URL — копируйте с карточки шлюза. Домен берётся из connect_page_url, не из домена сайта кабинета. Подробнее про отдельные магазины для WEBSITE — в Личный кабинет.
  • Метки «только бот» в предпросмотре: Telegram Stars, CryptoBot, перевод вручную и промокод на сайте не показываются.

YooKassa

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

Platega

Интеграция через Platega v2 (/v2/transaction/process). Способ оплаты (СБП, карты и т.д.) пользователь выбирает на странице Platega — в боте и админке отдельные коды методов больше не настраиваются.

  • 1Зарегистрируйтесь на platega.io и получите у менеджера:
    platega_merchant_id — ID мерчанта
    platega_api_secret — секретный ключ API
  • 2В личном кабинете Platega укажите Callback URL — скопируйте с карточки Platega в веб-админке (обычно https://<connect_page_url>/platega/callback).
  • 3Заполните ключи в веб-админке, включите «Показывать метод оплаты Platega» и сохраните.
💡
Набор доступных способов на стороне Platega (СБП, карты, крипта и т.д.) подключается через персонального менеджера — в боте это отдельно не задаётся.

Wata

  • 1Зарегистрируйтесь в Wata и создайте терминал. В ЛК получите Access Token (Bearer JWT) и при необходимости Terminal Public ID.
  • 2В настройках терминала Wata укажите webhook — URL с карточки Wata в веб-админке (обычно https://<connect_page_url>/wata/webhook).
  • 3В веб-админке заполните wata_access_token (обязательно) и при необходимости wata_terminal_public_id.
  • 4Включите «Показывать метод оплаты Wata» и сохраните. Метод доступен в боте и в личном кабинете на сайте.

Telegram Stars

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

Тарифы для Stars задаются в рублях, как и для остальных методов. В звёзды цена пересчитывается по курсу tgstar_rub_per_star (сколько рублей за 1 ⭐). Курс настраивается во вкладке Методы оплат, не в карточке тарифа. По умолчанию 2 ₽ за 1 ⭐.

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

CryptoBot

  • 1Откройте @CryptoBot → Crypto Pay → Создать приложение → получите API Token.
  • 2Укажите Webhook URL для Crypto Pay — скопируйте с карточки CryptoBot в веб-админке (обычно https://<connect_page_url>/cryptobot/). Задать его можно только вручную: откройте @CryptoBot → /pay → ваше приложение → раздел Webhooks. Метода для программной установки в Crypto Pay API нет.
  • 3В веб-админке укажите cryptobot_token.
  • 4Включите переключатель «Показывать метод оплаты CryptoBot» и сохраните.
💡
Оплаченные инвойсы подтверждаются через webhook Crypto Pay (invoice_paid). Дополнительно бот опрашивает статус в фоне и по кнопке «Проверить платёж» — на случай, если уведомление не дошло.

YooMoney

Оплата через форму Quickpay («Магазин»). Платёж подтверждается HTTP-уведомлением от YooMoney; при необходимости бот дополнительно опрашивает API operation-history.

✅
Минимум для работы (бот и сайт):
yoomoney_account — номер кошелька-получателя
yoomoney_notification_secret — секрет HTTP-уведомлений
+ webhook URL с карточки YooMoney в веб-админке + переключатель «Показывать YooMoney»
⚠️
yoomoney_token — OAuth-токен, необязателен. Для Quickpay и приёма webhook'ов он не нужен. Токен используется только как API-фоллбэк (operation-history), если подпись уведомления не сошлась. Можно включить YooMoney, оставив поле пустым.
Базовая настройка
  • 1На yoomoney.ru включите «Отправлять HTTP-уведомления», задайте секрет и укажите URL webhook — скопируйте с карточки YooMoney в веб-админке (обычно https://<connect_page_url>/yoomoney/).
  • 2В веб-админке заполните yoomoney_account и yoomoney_notification_secret (тот же секрет, что в YooMoney).
  • 3Включите «Показывать метод оплаты YooMoney» и сохраните.
OAuth-токен (опционально, API-фоллбэк)

Нужен только если хотите резервную проверку платежей через API. Для большинства установок достаточно webhook + секрета.

  • 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 в веб-админке.

Промокод и перевод вручную

В блоке «Другое» на вкладке методов оплаты:

  • •Промокод — переключатель show_payment_promo_code. Только бот.
  • •Перевод вручную — show_payment_manual и ссылки manual_transfer_link_30/60/90 (CloudTips и т.п.). Только бот.

Тарифы

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

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

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

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

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

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

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

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