Integracja Payory z WooCommerce Subscriptions

Jak połączyć Payora z WooCommerce Subscriptions

WooCommerce Subscriptions jest wymagające — i dobrze. Utrzymuje porządek w płatnościach cyklicznych, ale oznacza to też, że nie można traktować Payory jak zwykłej wtyczki do jednorazowych płatności i liczyć na to, że odnowienia same się obsłużą.

Ten poradnik dotyczy konkretnego zadania: dodania Payory do istniejącego sklepu WooCommerce, w którym działa już rozszerzenie Subscriptions, bez wprowadzania zmian w pozostałych elementach sklepu. Jeśli chcesz, by Payora obsługiwała tylko nowe zamówienia cykliczne, to wystarczy. Jeśli planujesz przebudować wszystkie procesy płatności, ten artykuł nie jest dla Ciebie.

Najpierw krótkie ostrzeżenie. Obsługa subskrypcji obejmuje płatności, powiadomienia o odnowieniach, zapisane metody płatności i dane zamówień, więc pominięcie jednego ustawienia może później spowodować problemy z odnowieniami.

1. Ustal, z jakim scenariuszem WooCommerce Subscriptions masz do czynienia

Zacznij od sklepu, który rzeczywiście prowadzisz, a nie od tego, jaki chciałbyś mieć. Jeśli WooCommerce już działa, a WooCommerce Subscriptions jest aktywne, zwykle chodzi o dodanie Payory do obsługi nowych subskrypcji bez zmiany istniejących produktów, podatków, metod dostawy czy szablonów wiadomości e-mail.

To skromny zakres — i właśnie o to chodzi. Celem nie jest przebudowa obsługi zamówień w całym sklepie, tylko skierowanie płatności za kwalifikujące się plany subskrypcyjne przez Payorę.

Jeśli Twój sklep nadal obsługuje wyłącznie płatności jednorazowe, zatrzymaj się tutaj i najpierw zmień jego strukturę. Jeśli subskrypcje już działają, przejdź dalej.

Szerszy kontekst dotyczący Payory w e-commerce znajdziesz w poradniku o bramkach płatności kryptowalutowych dla e-commerce, który pomoże porównać modele płatności przed wprowadzeniem zmian w aktywnym procesie zakupu.

2. Sprawdź wymagania dotyczące wtyczek i konta

Potrzebujesz dostępu administratora do WordPressa. Wymagane są też WooCommerce, WooCommerce Subscriptions oraz konto sprzedawcy Payora z danymi dostępowymi do środowiska produkcyjnego lub testowego.

Zanim cokolwiek zrobisz, sprawdź listę wtyczek. Czysty ekran administracyjny nie daje gwarancji, ale pozwala upewnić się, że podstawowe elementy są na miejscu.

Zaloguj się na konto Payora i sprawdź dane sprzedawcy, klucze API oraz wszelkie adresy zwrotne lub wartości webhooków udostępnione dla Twojego konta. Jeśli Payora podaje osobne dane do środowiska testowego i produkcyjnego, zapisz je w dwóch oddzielnych miejscach.

Nie pomijaj weryfikacji konta. Brakujący klucz może sprawić, że płatność za subskrypcję będzie wyglądać poprawnie po stronie klienta, a w tle nie zadziała obsługa płatności cyklicznych.

Upewnij się też, że Twoje konto właściciela sklepu lub dewelopera ma uprawnienia do edytowania ustawień płatności w WooCommerce. Jedno konto z ograniczonymi uprawnieniami może opóźnić całą konfigurację.

3. Znajdź ustawienia płatności Payora w WooCommerce

W WordPressie przejdź do WooCommerce, następnie do Ustawień, a potem do sekcji Płatności. To typowe miejsce, w którym znajdziesz bramki płatnicze, choć dokładna ścieżka może się różnić, jeśli Payora jest dostępna jako wbudowana opcja, osobne rozszerzenie lub niestandardowa integracja.

Na liście metod płatności poszukaj Payory. Jeśli widzisz przełącznik aktywacji i przycisk ustawień, prawdopodobnie korzystasz z bramki, którą można skonfigurować bezpośrednio w WooCommerce.

Jeśli Payora w ogóle się nie wyświetla, sprawdź, czy wtyczka jest zainstalowana, czy rozszerzenie jest aktywne i czy integracja nie wymaga osobnego łącznika. Trzy kontrole są lepsze niż jedno zgadywanie.

Zwróć uwagę na informacje dotyczące subskrypcji. Niektóre bramki obsługują zwykłe płatności przy kasie, ale nie odnowienia cykliczne. To ważniejsze niż nazwa przycisku — szczególnie jeśli szukasz rozwiązania jako bramka płatności do subskrypcji WooCommerce.

Krótka wskazówka: jeśli na stronie ustawień jest opcja trybu testowego, na razie ją włącz. Jedno kliknięcie w trybie produkcyjnym może utworzyć prawdziwe zamówienie subskrypcyjne, zanim będziesz na to gotowy.

4. Połącz Payorę z WooCommerce za pomocą danych dostępowych

Wpisz identyfikator sprzedawcy Payora, klucze API i wszystkie wymagane sekrety dokładnie tak, jak zostały podane. Jedna literówka może uniemożliwić uwierzytelnianie, a przy płatnościach cyklicznych możesz się o tym dowiedzieć dopiero przy pierwszej próbie odnowienia.

Jeśli konfiguracja obejmuje adres URL callbacku lub punkt końcowy webhooka, dodaj go w obu miejscach: na koncie Payora i w ustawieniach bramki WooCommerce, jeśli integracja wymaga obu wpisów. Zdarzenie odnowienia musi mieć możliwość przekazania informacji z powrotem do WooCommerce, by status subskrypcji mógł się zmienić po udanej lub nieudanej płatności.

To najbardziej techniczna część konfiguracji, ale wciąż sprowadza się głównie do dokładnego wpisywania danych. Kopiuj, wklejaj, sprawdzaj i zapisuj. Tak właśnie powinna przebiegać konfiguracja Payory w WooCommerce.

Jeśli potrzebujesz bardziej szczegółowej dokumentacji technicznej, zajrzyj do poradnika integracji Payora z API płatności kryptowalutowych. Będzie szczególnie przydatny, jeśli Twoja konfiguracja nie opiera się na standardowej bramce działającej od razu po instalacji.

Wielu właścicieli sklepów szuka informacji pod hasłem „jak połączyć Payorę z WooCommerce Subscriptions”, a potem niepotrzebnie komplikuje sobie sprawę. Jeśli bramka obsługuje już logikę zamówień cyklicznych, proces jest prostszy, niż się wydaje. Najważniejsze, by zarówno pierwsza płatność, jak i callback dotyczący odnowienia korzystały z danych tego samego konta Payora.

Zapisz ustawienia, odśwież stronę i sprawdź, czy nadal są widoczne. Ustawienie, które znika po odświeżeniu, nie zostało zapisane.

5. Skonfiguruj obsługę płatności za subskrypcje

Otwórz teraz ustawienia WooCommerce Subscriptions i sprawdź sposób obsługi odnowień. Najważniejsze kwestie to zapisane metody płatności, ponawianie nieudanych płatności oraz to, czy klienci mogą używać Payory zarówno do pierwszej płatności, jak i późniejszych odnowień.

Niektóre sklepy pozwalają płacić przez Payorę tylko podczas zakupu subskrypcji, a późniejsze odnowienia obsługują inną metodą. Inne powierzają Payorze obie płatności. Wybór zależy od zasad dotyczących Twoich produktów.

Jeśli bramka zapisuje dane płatnicze klienta w formacie rozpoznawanym przez WooCommerce Subscriptions, włącz opcję zapisanych metod płatności. Jeśli tak nie jest, nie wymuszaj tego ustawienia.

Dokładnie sprawdź zasady ponawiania płatności. Nieudane odnowienie może uruchomić wiadomości e-mail, zmiany statusu lub anulowanie subskrypcji. Te działania powinny odpowiadać zasadom obsługi klienta, a nie domyślnym ustawieniom, których nikt nie sprawdził.

Zwróć uwagę, czy jedna subskrypcja nie korzysta z różnych metod płatności. Może się tak zdarzyć, gdy klient zaczyna od jednej bramki, a później przechodzi na Payorę. Taka konfiguracja jest możliwa do opanowania, ale powinna być zamierzona.

Jeśli po uruchomieniu tej opcji chcesz praktycznie ocenić jakość płatności, przeczytaj poradnik o mierzeniu skuteczności płatności kryptowalutowych. Lepiej wcześnie skorygować problemy z odnowieniami, niż robić to po miesiącu zgłoszeń do pomocy technicznej.

6. Przetestuj zakup subskrypcji i pierwsze odnowienie

Najpierw przetestuj jeden produkt subskrypcyjny. Wystarczy jeden plan. Otwórz stronę produktu, złóż zamówienie subskrypcyjne i prześledź cały proces — od koszyka po potwierdzenie.

Jeśli to możliwe, użyj testowego konta klienta. Następnie sprawdź, czy WooCommerce utworzył rekord subskrypcji, zamówienie nadrzędne i przypisał prawidłowy status początkowy.

Test pierwszego odnowienia jest ważniejszy niż test pierwszej płatności. Płatność może się udać, choć logika odnowień zawiedzie po cichu w późniejszym terminie.

Wywołaj zdarzenie odnowienia w środowisku testowym albo postępuj zgodnie z skonfigurowanym harmonogramem. Następnie sprawdź, czy WooCommerce aktualizuje status subskrypcji po otrzymaniu wyniku płatności od Payory.

Przed tym etapem warto skorzystać z listy kontrolnej z artykułu jak przetestować płatność kryptowalutową. Przydadzą się tu te same nawyki: przetestuj płatność, a potem sprawdź jej konsekwencje.

Zapisz dokładny wynik testu. Czy zamówienie otrzymało status aktywny, oczekujący czy wstrzymany? Czy wysłano wiadomość o odnowieniu? Czy w notatce do zamówienia w panelu administracyjnym pojawiła się oczekiwana informacja?

Krótka uwaga: nigdy nie pomijaj testu odnowienia.

7. Sprawdź komunikaty dla klientów i obsługę zamówień w panelu administracyjnym

Klienci powinni widzieć przy kasie prawidłowy komunikat dotyczący płatności, zgodny z tym, jak działa Payora. Jeśli bramka przekierowuje na inną stronę, poinformuj o tym. Jeśli potwierdzenie płatności przychodzi z opóźnieniem, nie informuj klienta, że zamówienie jest zrealizowane, zanim rzeczywiście tak się stanie.

Sprawdź wiadomość e-mail z potwierdzeniem subskrypcji, potem wiadomość o odnowieniu, a następnie e-mail o anulowaniu, jeśli Twój sklep go wysyła. Trzy wiadomości to trzy okazje do tego, by użyć niespójnych sformułowań.

W panelu administracyjnym otwórz rekord subskrypcji i powiązane z nim zamówienie. Powinna być widoczna nazwa bramki, status płatności oraz ewentualna notatka wskazująca próbę odnowienia lub wynik callbacku.

Jeśli zespół pomocy technicznej obsługuje zwroty lub ręczną weryfikację, jego pracownicy również muszą widzieć te same dane. Przejrzysty rekord administracyjny oszczędza czas przy pierwszych dziesięciu zgłoszeniach, a zapewne także później.

Przydatnym materiałem wewnętrznym może być poradnik o przechodzeniu z ręcznej obsługi płatności kryptowalutowych na zautomatyzowaną. Niektóre sklepy rezygnują z ręcznego przetwarzania płatności na rzecz rozliczeń subskrypcyjnych i muszą zachować spójność dokumentacji.

Nie zostawiaj niejasnych komunikatów. „Otrzymaliśmy płatność” jest właściwe tylko wtedy, gdy odnowienie rzeczywiście zostało zakończone. Jeśli sieć nadal potwierdza transakcję, napisz to wprost.

8. Uwzględnij szczególne przypadki dotyczące obecnych subskrybentów

Obecni subskrybenci bywają największym wyzwaniem. Jeśli już płacą inną metodą, zastanów się, czy mają przy niej pozostać, czy przejść na Payorę dopiero przy ręcznym odnowieniu lub ponownym wykupieniu subskrypcji.

W wielu sklepach najprostsza zasada jest najlepsza: nowe subskrypcje korzystają z Payory, a obecni subskrybenci pozostają przy dotychczasowej metodzie płatności do czasu naturalnej zmiany. Dzięki temu nie zmuszasz klientów do działania, o które nigdy ich nie proszono.

Jeśli chcesz przenieść obecnych subskrybentów na Payorę, sprawdź, czy WooCommerce Subscriptions pozwala zmienić metodę płatności bez tworzenia nowej subskrypcji. Jeśli nie, przygotuj ścieżkę ponownego wykupienia subskrypcji i jasno wyjaśnij klientom, na czym polega zmiana.

To wyjaśnienie ma znaczenie. Klienci mogą zaakceptować nową metodę płatności, jeśli wiedzą, dlaczego jest wprowadzana. Nie lubią niespodzianek bardziej niż zmian.

Administratorzy sklepu powinni też ustalić, co zrobić ze starszymi zamówieniami odnowieniowymi. Historia powinna pozostać czytelna i kompletna. Nie usuwaj dokumentacji tylko dlatego, że zmieniła się bramka płatnicza.

Często pojawia się praktyczne pytanie: co zrobić, jeśli klient chce użyć Payory tylko przy następnym odnowieniu? Najpierw przetestuj ten proces w środowisku testowym, ponieważ obiekt subskrypcji i zapis metody płatności mogą nie zmienić się jednocześnie.

Powiązana kwestia to dostępność Payory dla wszystkich produktów albo tylko dla subskrypcji. Jeśli Twój sklep sprzedaje zarówno towary fizyczne, jak i usługi rozliczane cyklicznie, ustal osobne zasady już teraz, zamiast odkładać tę decyzję na później.

Miej tę listę pod ręką podczas wdrażania. Celowo jest krótka.

Jeśli później zechcesz zmienić strukturę samej integracji, zajrzyj do artykułu o bramkach płatności kryptowalutowych dla freelancerów — ale tylko jeśli Twój model subskrypcyjny przypomina rozliczanie klientów i fakturowanie, bo właśnie w tych obszarach oczekiwania dotyczące płatności cyklicznych często się pokrywają.

Ostatnia praktyczna wskazówka: jeśli Payora i WooCommerce nie zgadzają się co do czasu zdarzenia, najpierw sprawdź wpisy w logach, a dopiero potem zawartość ekranu. Ekrany mogą się aktualizować z opóźnieniem. Logi pokazują, co się wydarzyło.