Розробка платіжного шлюзу 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 #Автоматизація #ПлатіжнийШлюз