Opracowanie bramki płatniczej WayForPay na n8n dla bota Telegram

Cel:
Stworzenie w pełni autonomicznego systemu zarządzania subskrypcjami dla bota Telegram. Kluczowym wymaganiem jest integracja z ukraińskim serwisem płatniczym WayForPay w celu automatycznego wystawiania faktur i aktywacji dostępu po dokonaniu płatności. System powinien niezawodnie śledzić statusy subskrypcji, aktualizować dane użytkowników w Google Sheets oraz spełniać rygorystyczne wymagania bezpieczeństwa API WayForPay.

Mój wkład:
Projekt rozpoczął się od fundamentalnego problemu technicznego: standardowe platformy no-code, takie jak Make.com, nie mają wbudowanych narzędzi do generowania i walidacji podpisów kryptograficznych HMAC-MD5, które są niezbędne do pracy z WayForPay. To uniemożliwiało bezpośrednią integrację.

Mój wkład polegał na opracowaniu "od podstaw" nowej architektury na self-hosted n8n, która w pełni rozwiązywała ten problem. Zaprojektowałem niezawodny system dwuskładnikowy, dzieląc logikę tworzenia faktur i przetwarzania płatności na dwa oddzielne, ale ściśle zintegrowane workflow, co zapewniło maksymalną stabilność i łatwość w debugowaniu.

Rozwiązanie:
Ostateczne rozwiązanie składa się z dwóch zoptymalizowanych procesów roboczych w n8n, które zapewniają pełny cykl przetwarzania płatności.

Workflow 1: Tworzenie Faktury
Serce tego procesu stanowi łańcuch węzłów Crypto i Code.

Przygotowanie Żądania: Za pomocą węzła Code dynamicznie formułowane jest idealnie ustrukturyzowane ciało żądania JSON, co gwarantuje poprawność typów danych (liczby, tablice), których wymaga API.

Generowanie Podpisu: Węzeł Crypto tworzy unikalny podpis HMAC-MD5 dla wychodzącego żądania.

Tworzenie Faktury: Ostateczne żądanie HTTP wysyła podpisane żądanie do WayForPay, otrzymując w odpowiedzi unikalny link do płatności (invoiceUrl), który natychmiast jest wysyłany do użytkownika w Telegramie.

Workflow 2: Przetwarzanie i Walidacja Płatności
Ten workflow aktywuje się przez Webhook po pomyślnej płatności klienta.

Parsowanie Danych: Pierwszy węzeł Code okazał się krytycznie ważny dla "rozpakowania" danych, ponieważ WayForPay wysyłał webhook w nieoczekiwanym formacie x-www-form-urlencoded.

Sprawdzanie Bezpieczeństwa: Łańcuch Crypto -> IF wykonuje najważniejszą funkcję — odtwarza podpis HMAC-MD5 z otrzymanych danych i porównuje go z podpisem od WayForPay. Proces kontynuuje się tylko w przypadku pełnego dopasowania i statusu Approved.

Aktualizacja Systemu: W przypadku pomyślnej walidacji, węzeł Google Sheets aktualizuje status subskrypcji użytkownika, ustawia nową datę zakończenia i resetuje liczniki użycia. Użytkownik otrzymuje natychmiastowe powiadomienie w Telegramie.

Zakończenie Transakcji: Ostateczny łańcuch węzłów generuje kolejny podpis i wysyła przez Respond to Webhook poprawną odpowiedź dla WayForPay, potwierdzając pomyślne odebranie webhooka.

Wynik:
Pomyślnie opracowano i wdrożono autonomiczny system płatności, który w pełni zautomatyzował proces zarządzania subskrypcjami w bocie Telegram. Klient otrzymał niezawodny i bezpieczny workflow, który działa 24/7 i gwarantuje:

Niezawodną integrację ze skomplikowanym API serwisu płatniczego WayForPay.

Pełne bezpieczeństwo dzięki kryptograficznej walidacji każdego żądania.

Natychmiastową aktywację subskrypcji i powiadomienia użytkowników bez jakiejkolwiek ręcznej interwencji.

Stabilną pracę dzięki podzielonej architekturze i poprawnej obróbce odpowiedzi.

#n8n #WayForPay #APIIntegration #WorkflowAutomation #Telegram #JavaScript #PaymentGateway #Webhook #HMAC #GoogleSheets #SubscriptionAutomation #BusinessAutomation #Automatyzacja #BramaPłatnicza