На странице
  1. База знаний
  2. Платёжки и бизнес

Env и вебхуки

Дословные конфиги подключения и грабли.

Пруфов: 16Обновлено 17.09.2026Исходник 2 мин чтения

Есть сводка по-человечески

Эта страница — архив цитат из чата как есть. По каждой платёжке собрана карточка: комиссии, что требуют при подключении, есть ли в боте, плюсы, минусы и хронология с датами. Каталог платёжек.

Общий запуск бота (08.11.2025)

BOT_TOKEN=...
ADMIN_IDS=...
BOT_RUN_MODE=webhook            # 0: webhook, 1: polling
WEBHOOK_URL=https://hooks.domain.com/
WEBHOOK_SECRET_TOKEN=super-secret-token
WEB_API_ENABLED=true
WEB_API_ALLOWED_ORIGINS=...
# настройки Web API хранятся в БД; env имеет приоритет

Platega

PLATEGA_ENABLED=true
PLATEGA_MERCHANT_ID=your_merchant_id
PLATEGA_SECRET_KEY=your_secret
PLATEGA_RETURN_URL=https://your-domain.com/payment-failed
PLATEGA_FAILED_URL=https://your-domain.com/payment-failed

CryptoBot (v2.2.5, пруф, 09.09.2025)

CRYPTOBOT_ENABLED=true
CRYPTOBOT_API_TOKEN=your_token
CRYPTOBOT_WEBHOOK_SECRET=your_secret
CRYPTOBOT_TESTNET=false
CRYPTOBOT_ASSETS=USDT,TON,BTC,ETH,LTC,BNB,TRX,USDC
CRYPTOBOT_INVOICE_EXPIRATION=<срок>
# таблица cryptobot_payments, enum PaymentMethod + CRYPTOBOT
# курс USD/RUB: ЦБ РФ + exchangerate-api.com, кеш 1 час

Проверка/отмена платежей

PAYMENT_VERIFICATION_AUTO_CHECK_ENABLED=true
PAYMENT_VERIFICATION_AUTO_CHECK_INTERVAL_MINUTES=10
# автоотмена неоплаченных подписок; умные скидки после пополнения

Ценообразование трафика (v2.0.5, пруф)

TRAFFIC_SELECTION_MODE=selectable   # selectable | fixed
FIXED_TRAFFIC_LIMIT_GB=0            # 0 = безлимит
# для fixed проставить цены всем: PRICE_TRAFFIC_5/10/25/50/100/250/0=0

Пути вебхуков (Caddy/Nginx reverse-proxy)

  • Канонические пути бота: /yookassa-webhook, /platega-webhook, /cryptobot-webhook, /wata-webhook, /heleket-webhook, /tribute-webhook, /omney-webhook.
  • Tribute: при выключенном трибьюте webhook-сервер не запускается; адрес http://0.0.0.0:8081/tribute-webhook пруф.
  • С 06.08.2026 Platega требует заголовки X-MerchantId / X-Secret в GET-запросах статуса транзакции, иначе 401 пруф.

Грабли вебхуков

  • Вебхук-роуты платёжек монтируются только по env-флагу *_ENABLED, а не по DB-конфигу payment_method_configs: включение через админку (is_enabled=true) без env-флага → GET вебхука отдаёт 404; пропущенный колббек = висящий платёж пруф.
  • «Платёж есть в платёжке, в боте не пополнился» → URL вебхука не был прописан в настройках платёжки пруф.
  • HTTP 405 при отправке хука → в 99% случаев виноват реверс-прокси (опыт с Lava) пруф.
  • В ЛК платёжки есть вся инфа о вебхуке и причина провала; вебхук переотправляется отдельным пунктом «переотправить» пруф.
  • Если платёжка выключена и бот перезагружен, после включения оплата проходит, но хуки не работают (feature-запрос) пруф.
  • Remnawave → Bedolaga: синхронизация подписок через вебхуки панели, доки docs.bedolagam.ru/integrations/remnawave#webhooks-от-панели; без вебхуков изменения на панели не видны в боте пруф. Ошибка RemnaWave webhook: invalid signature http_path=/remnawave-webhook — чинить подпись/токен пруф.
  • Скорость вебхуков: cisPay 5–7 сек пруф; WATA 2–3 минуты (критично) пруф.

Вывод средств (bedolaga-cabinet)

Способы вывода в кабинете: СБП, карта РФ, карта других стран, SEPA, крипта, CryptoBot, TG Stars, баланс бота пруф. Реф-баланс нельзя конвертировать в подписку — только реф-доход в общий баланс пруф. Рефка: 50% с первого пополнения, 25% с последующих пруф.