Вебхук — это запрос от платёжной системы на ваш сервер с сообщением о событии: платёж прошёл, не прошёл, подписка отменена, возврат оформлен. Вся автоматизация подписок держится на них.
Правила приёма вебхуков:
— Проверяйте подпись. Каждая платёжка подписывает запрос секретом. Без проверки любой может отправить вам «платёж прошёл».
— Отвечайте быстро. Приняли запрос, записали в очередь, ответили 200. Обработка — потом. Если сервер думает десять секунд, платёжка посчитает вебхук недоставленным и пришлёт снова.
— Идемпотентность. Один и тот же вебхук может прийти дважды. Храните идентификаторы событий и пропускайте повторы.
— Логируйте всё сырое. Тело запроса как есть, до разбора. Когда что-то пойдёт не так, это единственный источник правды.
— Не доверяйте порядку. Событие «подписка продлена» может прийти раньше «платёж создан». Логика должна переживать это.
И проверьте, что адрес вебхука не закрыт базовой авторизацией или защитой от ботов. Классическая причина «платежи не активируются» — сервер отдаёт 403 на вебхуки.
Пейволы и Подписки
@paywall_setup
Вебхуки платёжных систем: как их ловить, чтобы ничего не потерять
Этот пост опубликован в Telegram-канале Пейволы и Подписки (@paywall_setup). Все его публикации — на странице канала.
Открыть в Telegram