Перейти к содержимому
RWP Shop Docs

Платежные системы

Настройка Platega

Настройте Platega для приема оплаты через СБП, карты и криптовалюту

Platega — платежный агрегатор с поддержкой нескольких методов оплаты: СБП (QR-код), российские карты, карточный эквайринг, международные карты и криптовалюта.

  • Аккаунт мерчанта Platega (app.platega.io)
  • Merchant ID и секретный ключ
  • Публичный HTTPS-домен бота для приема вебхуков
  1. Пользователь выбирает тариф и один из методов Platega — бот создает транзакцию через API Platega (POST /transaction/process) и выдает ссылку на оплату.
  2. После оплаты Platega отправляет вебхук на адрес PLATEGA_WEBHOOK_URL. Бот проверяет заголовки X-MerchantId и X-Secret.
  3. При статусе CONFIRMED бот активирует подписку через Remnawave; при CANCELED / CHARGEBACKED покупка отменяется.
  • Зарегистрируйтесь на app.platega.io
  • Получите Merchant ID и Secret в личном кабинете
PLATEGA_ENABLED=true
PLATEGA_MERCHANT_ID=ваш_merchant_id
PLATEGA_SECRET=ваш_секрет
PLATEGA_WEBHOOK_URL=/webhook/platega/СЛУЧАЙНЫЙ_СЕКРЕТ
# Включите нужные методы оплаты (минимум один)
PLATEGA_SBP_ENABLED=true
PLATEGA_CARDS_ENABLED=true
PLATEGA_ACQUIRING_ENABLED=false
PLATEGA_WORLDWIDE_ENABLED=false
PLATEGA_CRYPTO_ENABLED=false

Случайный секрет для пути вебхука сгенерируйте командой:

openssl rand -hex 32

В личном кабинете Platega укажите URL для уведомлений:

https://ваш-домен.com/webhook/platega/СЛУЧАЙНЫЙ_СЕКРЕТ
docker compose down && docker compose up -d
  • Отправьте /start боту
  • Выберите подписку
  • Выберите один из методов Platega (например, СБП)
  • Оплатите и убедитесь, что подписка активировалась
Переменная Обязательна Описание
PLATEGA_ENABLED да Включить/отключить Platega (true/false)
PLATEGA_MERCHANT_ID да Идентификатор мерчанта
PLATEGA_SECRET да Секретный ключ (также используется для проверки вебхуков)
PLATEGA_WEBHOOK_URL да Путь вебхука, например /webhook/platega/секрет
PLATEGA_SBP_ENABLED нет Оплата через СБП (QR-код)
PLATEGA_CARDS_ENABLED нет Российские банковские карты
PLATEGA_ACQUIRING_ENABLED нет Карточный эквайринг
PLATEGA_WORLDWIDE_ENABLED нет Международные карты
PLATEGA_CRYPTO_ENABLED нет Криптовалюта

Каждый включенный метод отображается отдельной кнопкой в меню оплаты бота.

Бот проверяет каждый входящий вебхук:

  • Заголовки X-MerchantId и X-Secret должны совпадать с PLATEGA_MERCHANT_ID и PLATEGA_SECRET — иначе запрос отклоняется с кодом 401
  • Используйте длинный случайный сегмент в пути PLATEGA_WEBHOOK_URL
  • Проверьте, что PLATEGA_WEBHOOK_URL задан и URL зарегистрирован в кабинете Platega
  • Проверьте, что домен бота доступен извне по HTTPS
  • Просмотрите логи бота: docker compose logs -f remnawave-telegram-shop-bot
  • Убедитесь, что PLATEGA_ENABLED=true
  • Включите хотя бы один метод: PLATEGA_SBP_ENABLED=true и т.д.
  • Перезапустите бота после изменения .env
  • Проверьте, что Merchant ID и Secret в кабинете Platega совпадают со значениями в .env
  • Platega: app.platega.io
  • Проблемы: Сообщайте на GitHub