Разработка платежного шлюза WayForPay на n8n для Telegram-бота

Мета:
Создать полностью автономную систему управления подписками для Telegram-бота. Ключевое требование — интеграция с украинским платежным сервисом WayForPay для автоматического выставления счетов и активации доступа после оплаты. Система должна надежно отслеживать статусы подписок, обновлять данные пользователей в Google Sheets и соответствовать строгим требованиям безопасности API WayForPay.

Мой Вклад:
Проект начался с фундаментальной технической проблемы: стандартные no-code платформы, такие как Make.com, не имеют встроенных инструментов для генерации и валидации криптографических подписей HMAC-MD5, которые обязательны для работы с WayForPay. Это делало прямую интеграцию невозможной.

Мой вклад заключался в разработке "с нуля" новой архитектуры на self-hosted n8n, которая полностью решала эту проблему. Я спроектировал надежную двухкомпонентную систему, разделив логику создания счетов и обработки платежей на два отдельных, но тесно интегрированных воркфлоу, что обеспечило максимальную стабильность и легкость в отладке.

Решение:
Финальное решение состоит из двух оптимизированных рабочих процессов в n8n, которые обеспечивают полный цикл обработки платежа.

Воркфлоу 1: Создание Счета
Сердцем этого процесса является цепочка узлов Crypto и Code.

Подготовка Запроса: С помощью узла Code динамически формируется идеально структурированное JSON-тело запроса, что гарантирует правильность типов данных (числа, массивы), которые требует API.

Генерация Подписи: Узел Crypto создает уникальную HMAC-MD5 подпись для исходного запроса.

Создание Счета: Финальный HTTP Request отправляет подписанный запрос в WayForPay, получая в ответ уникальную ссылку на оплату (invoiceUrl), которая немедленно отправляется пользователю в Telegram.

Воркфлоу 2: Обработка и Валидация Платежа
Этот воркфлоу активируется через Webhook после успешной оплаты клиентом.

Парсинг Данных: Первый узел Code оказался критически важным для "распаковки" данных, так как WayForPay отправлял вебхук в неожиданном формате x-www-form-urlencoded.

Проверка Безопасности: Цепочка Crypto -> IF выполняет важнейшую функцию — воспроизводит HMAC-MD5 подпись из полученных данных и сравнивает ее с подписью от WayForPay. Процесс продолжается только при полном совпадении и статусе Approved.

Обновление Системы: В случае успешной валидации, нода Google Sheets обновляет статус подписки пользователя, устанавливает новую дату окончания и сбрасывает счетчики использования. Пользователь получает мгновенное уведомление в Telegram.

Завершение Транзакции: Финальная цепочка узлов генерирует еще одну подпись и отправляет через Respond to Webhook корректный ответ для WayForPay, подтверждая успешное получение вебхука.

Результат:
Успешно разработана и внедрена автономная платежная система, которая полностью автоматизировала процесс управления подписками в Telegram-боте. Клиент получил надежный и безопасный воркфлоу, который работает 24/7 и гарантирует:

Надежную интеграцию со сложным API платежного сервиса WayForPay.

Полную безопасность благодаря криптографической валидации каждого запроса.

Мгновенную активацию подписок и уведомления пользователей без какого-либо ручного вмешательства.

Стабильную работу благодаря разделенной архитектуре и корректной обработке ответов.

#n8n #WayForPay #APIIntegration #WorkflowAutomation #Telegram #JavaScript #PaymentGateway #Webhook #HMAC #GoogleSheets #SubscriptionAutomation #BusinessAutomation #Автоматизация #ПлатежныйШлюз