Ошибки → фиксы
Самое частое по скриптам.
- «Подпись не совпала…» (YooKassa) —
YOOKASSA_WEBHOOK_SECRET=оставить ПУСТЫМ (юкасса не шлёт подпись, проверять нечего) пруф. - CryptoBot «Неверная подпись» — закомментировать CRYPTOBOT_WEBHOOK_SECRET пруф.
- TelegramConflictError: can't use getUpdates while webhook is active — удалить вебхук
https://api.telegram.org/bot<TOKEN>/deleteWebhookпруф. - 401 «webhook с неверным секретом» — openssl rand -hex 32 → WEBHOOK_SECRET_TOKEN, deleteWebhook,
make reloadпруф. Bad Request: bad webhook: Failed to resolve host— DNS у хостера (spaceweb-веха 04.04.2026); фикс: домен у нормального хостера / A-запись / сменить DNS пруф.Failed to resolve hostпосле обновления — DNS временно не резолвится, проходит само через ~30 мин пруф.- 405 на /yookassa-webhook — норм (Method not allowed = слушает) пруф.
{"status":"ok","message":"YooKassa webhook endpoint is working"…}— норм ответ на GET пруф.ValueError: path should be started with / or be empty— слеш убрать в webhook path env пруф.- Поллинг работает, вебхук нет — чаще всего реверс-прокси не настроен или DNS пруф.
- Юкасса webhook IP-allowlist:
YOOKASSA_TRUSTED_PROXY_NETWORKS=185.71.76.0/24,185.71.77.0/24пруф. - WATA IP-allowlist: 62.84.126.140, 51.250.106.150 пруф.
- Platega Callback URL в кабинете — «именно с путём, голый домен не работает» пруф.
- Lava Base URL =
https://api.lava.ru(старый gate.lava.ru не существует); рабочие эндпоинты/business/invoice/create|status(только Business-аккаунт) пруф. - Бесплатный
WEBHOOK_SECRET_TOKENи юкасса — см. выше. - «Ремна-вебхуки отдали Test notification sent, но в ТГ-группу не пришло» — настроить NOTIFICATIONS_TOPIC в боте пруф.
BEDOLAGA_API_URL==WEBHOOK_URL(или /api) для кастомной кабины пруф.- FreeKassa webhook: warning
Freekassa webhook: недоверенный IP— добавить IP платёжки в доверенные пруф. - RollyPay webhook: URL настраивается при создании кассы; nginx:
location = /rollypay-webhook { proxy_pass http://127.0.0.1:8080; … }пруф. - Overpay env: OVERPAY_ENABLED=false; OVERPAY_USERNAME; OVERPAY_PASSWORD; OVERPAY_PROJECT_ID; OVERPAY_P12_PATH=/app/certs/client.p12; OVERPAY_P12_PASSPHRASE; OVERPAY_API_URL=https://api.overpay.io; OVERPAY_PAYMENT_METHODS=card,fps; OVERPAY_DISPLAY_NAME=Overpay; OVERPAY_CURRENCY=RUB; OVERPAY_MIN_AMOUNT_KOPEKS=10000; OVERPAY_MAX_AMOUNT_KOPEKS=100000; OVERPAY_WEBHOOK_PATH=/overpay-webhook; OVERPAY_RETURN_URL=; OVERPAY_LIFETIME_MINUTES=… пруф
- Platega env (рабочие ключи): PLATEGA_ENABLED=true; PLATEGA_MERCHANT_ID=; PLATEGA_SECRET=; PLATEGA_BASE_URL=https://app.platega.io; PLATEGA_DISPLAY_NAME=Platega; PLATEGA_RETURN_URL/FAILED_URL; PLATEGA_CURRENCY=RUB; PLATEGA_ACTIVE_METHODS=2,10,11,12,13; PLATEGA_MIN_AMOUNT_KOPEKS=100; PLATEGA_MAX_AMOUNT_KOPEKS=100000000; PLATEGA_WEBHOOK_PATH=/platega-webhook; PLATEGA_WEBHOOK_HOST=0.0.0.0; PLATEGA_WEBHOOK_PORT=8086 пруф