Magento bywa wymagające. Konfiguracja płatności też. Jeśli zastanawiasz się, jak połączyć Payora z Magento, zacznij od ustalenia, czy pracujesz na Magento 2, czy na Adobe Commerce, bo panele administracyjne są na tyle podobne, że łatwo je pomylić, a na tyle różne, że można stracić godzinę. Tę Payora Magento konfiguracja warto zaplanować przed wdrożeniem, zamiast poprawiać ustawienia w pośpiechu.
Ten przewodnik sprawdzi się w sklepach, do których masz dostęp do panelu administracyjnego, możesz edytować metody płatności i zmieniać ustawienia modułu bez czekania na programistę na każdym kroku. Jeśli Twój sklep działa na ograniczonych uprawnieniach, najpierw zdobądź tymczasowy dostęp. Brak jednej roli może zatrzymać cały proces.
1. Potwierdź, że to właściwa konfiguracja Magento dla Payora
Skorzystaj z tej ścieżki, jeśli Twój sklep działa na Magento 2 lub Adobe Commerce i możesz zainstalować albo włączyć moduł płatności. Starsze wersje Magento często wymagają innego podejścia serwisowego, podobnie jak sklepy z mocno zmodyfikowanym checkoutem. Nadpisanie motywu może ukryć metodę płatności nawet wtedy, gdy moduł jest aktywny.
Sprawdź, kto odpowiada za trzy rzeczy, zanim ruszysz ustawienia płatności: kod źródłowy, konfigurację płatności i punkt końcowy webhooka. Jeśli choć jedna z tych rzeczy jest po stronie zewnętrznej, potrzebujesz ich akceptacji. Brzmi biurokratycznie, dopóki działający checkout nie padnie o 18:00.
Dla zespołów porównujących opcje Payora pasuje do sklepów, które chcą płatności kryptowalutowych w Magento bez przebudowy całego procesu finalizacji zakupu. Jeśli nadal zastanawiasz się, jak Payora ma działać w serwisie, przeczytaj też poradnik czym jest bramka płatności kryptowalutowych i; pomaga ocenić, czy potrzebujesz płatności bezpośrednio w checkoutcie, płatności w formie faktury, czy obu rozwiązań. W praktyce wtyczka Payora do Magento ma ułatwić właśnie tę część procesu.
2. Zbierz dane płatnicze Magento, których będzie potrzebować Payora
Przed instalacją zbierz dokładne wartości, o które poprosi moduł. Minimum to klucze API, identyfikator sprzedawcy, adres callbacku lub webhooka oraz ustawienia widoku sklepu albo waluty, których planujesz użyć. Brak jednego pola zwykle oznacza powtarzane testowe zapisy i chaotyczne logi.
Zapisz te wartości raz. Potem sprawdź je ponownie. Błąd małej litery w adresie endpointu może zatrzymać potwierdzanie płatności zanim w ogóle dotrze do Magento, a taki problem wygląda jak „płatność oczekuje” aż do chwili, gdy ktoś zajrzy do logów.
Korzystaj z nazewnictwa zespołu płatniczego, jeśli takie istnieje. Jeśli jedno konto sprzedawcy obsługuje kilka sklepów, oznacz każdy widok sklepu wyraźnie. W przeciwnym razie pierwsza prośba o zwrot zamieni się w zgadywankę.
Wiele sklepów ustawia tu także reguły walutowe. Jeśli katalog używa USD, ale checkout ma pokazywać EUR dla jednego widoku sklepu, potwierdź, że Payora i Magento zgadzają się co do listy obsługiwanych walut. Jedna niezgodność i metoda płatności może zniknąć w checkoutcie bez oczywistego ostrzeżenia.
3. Zainstaluj lub włącz moduł płatności Payora w Magento
Konfiguracja bramki płatniczej w Magento zwykle zaczyna się od plików modułu, a nie od ekranu ustawień. Umieść rozszerzenie tam, gdzie oczekuje tego Twój proces wdrożeniowy, a następnie wykonaj standardowy krok aktualizacji lub włączenia używany przez zespół. Jeśli sklep działa w oparciu o Composer, dopilnuj, by wersja była zgodna z resztą kodu sklepu.
Po wdrożeniu otwórz panel administracyjny i sprawdź, czy moduł pojawił się wśród metod płatności. Chodzi o potwierdzenie w interfejsie, a nie tylko zielony log wdrożenia. Jeśli moduł jest obecny w kodzie, ale nie ma go w panelu Admin, Magento nie zarejestrowało go jeszcze w pełni.
W niektórych sklepach potrzebne jest też wyczyszczenie cache’a lub reindeksacja konfiguracji, zanim metoda się pojawi. Nie zgaduj. Uruchom tę samą checklistę po wdrożeniu, której używasz przy każdej nowej metodzie płatności, potem odśwież stronę ustawień płatności i wyszukaj Payora po nazwie.
Jeśli potrzebujesz punktu odniesienia dla pól po stronie programisty i zachowania callbacków, strona dokumentacja deweloperska, API bramki płatności kryptowalutowych jest właściwym miejscem, by sprawdzić dokładne nazwy API. Niewielkie różnice w polach mają tu znaczenie.
4. Dokończ konfigurację bramki płatności Magento w panelu Admin
Otwórz obszar konfiguracji płatności i najpierw uzupełnij podstawowe ustawienia. Wybierz właściwy tryb środowiska, wpisz tytuł wyświetlany klientom i potwierdź, że metoda płatności jest włączona dla odpowiedniego widoku sklepu. To ten etap, który wiele zespołów robi w pośpiechu, a skutki wychodzą później.
Ustaw dokładnie dozwolone waluty. Jeśli sklep sprzedaje w 2 walutach, obie muszą być akceptowane przez bramkę i dozwolone w konfiguracji bramki płatności Magento. Jeśli jedna waluta nie jest obsługiwana, wyłącz ją tutaj zamiast pozwalać klientom odkryć problem dopiero w checkoutcie.
Mapowanie statusów zamówień wymaga uwagi. Zamówienie opłacone nie powinno mieć tego samego statusu co nieopłacone. Ustaw stan początkowy, stan po potwierdzeniu płatności oraz ewentualny stan do ręcznej weryfikacji, aby obsługa klienta mogła odczytać oś czasu na pierwszy rzut oka.
Reguły wyświetlania są proste, ale przydatne. Ogranicz Payora do stron checkoutu, gdzie ma to sens, i nie pokazuj jej w zapytaniach ofertowych ani w wewnętrznych zamówieniach administracyjnych, chyba że masz konkretny proces. Jeden sprzedawca, z którym pracowałem, zostawił metodę widoczną wszędzie, a support przez tydzień odpowiadał na pytania, dlaczego zamówienia pracownicze wyglądają jak zamówienia klientów.
5. Skonfiguruj płatności kryptowalutowe Magento dla procesu checkout
Teraz liczy się sam przebieg płatności. W przypadku płatności kryptowalutowych w Magento klient zwykle wybiera Payora, widzi instrukcje i następnie wysyła środki przez ścieżkę płatności udostępnioną przez bramkę. Utrzymaj ten proces krótki. Ludzie szybko rezygnują z długich stron płatności.
Zdecyduj, gdzie po checkoutcie mają pojawiać się instrukcje płatności. Niektóre sklepy umieszczają je na stronie sukcesu zamówienia, inne kierują klienta na dedykowaną stronę płatności. Niezależnie od rozwiązania klient musi wyraźnie widzieć kwotę, aktywo płatnicze i okno czasowe. Jeśli te informacje są ukryte za drugim logowaniem, spodziewaj się zgłoszeń do supportu.
Po utworzeniu faktury Magento powinno pokazywać zamówienie jako oczekujące, dopóki Payora nie potwierdzi płatności. To oczekiwanie jest normalne. Nie oznaczaj zamówienia jako przetwarzanego zbyt wcześnie, bo dział finansowy będzie musiał później to odkręcać.
Jeśli sklep obsługuje subskrypcje lub stałych klientów, używaj prostego języka płatności. „Zapłać z Payora” działa lepiej niż techniczny opis, który zrozumie tylko zespół operacyjny. Klient chce dokończyć jedną płatność, a nie studiować protokół.
6. Skonfiguruj obsługę zamówień, faktur i statusów
Obsługa zamówień to miejsce, w którym moduły płatności pokazują swoją wartość. Ustal, co dzieje się, gdy Payora potwierdza płatność, gdy płatność wygasa i gdy klient anuluje proces w połowie. Jeśli bramka wysyła poprawny callback, a Magento nadal trzyma zamówienie jako oczekujące, mapowanie jest błędne.
Ustaw zasady tworzenia faktur przed uruchomieniem produkcyjnym. Niektóre sklepy tworzą fakturę dopiero po potwierdzonej płatności, inne wcześniej, z powodów księgowych. Oba podejścia mogą działać, ale reguła musi być ustalona z góry, żeby support nie improwizował na żywych zamówieniach.
Nieudane płatności potrzebują własnej ścieżki. Jeśli Payora zgłasza błąd, Magento nie powinno bez końca trzymać starej etykiety „oczekuje na płatność”. Zamknij sprawę stanem nieudanym lub anulowanym, a potem upewnij się, że klient może spróbować ponownie bez tworzenia duplikatów zamówień.
Jeśli chodzi o callbacki i kontrole bezpieczeństwa, warto zajrzeć do artykułu najlepsze praktyki bezpieczeństwa dla bramki płatności kryptowalutowych. Podpisany webhook i zweryfikowane źródło to nudne szczegóły. To one jednak zatrzymują większość prób oszustw płatniczych.
I jeszcze jedno: zwroty i anulowania powinny mieć osobny przebieg niż potwierdzanie płatności. Jeśli zespół operacyjny realizuje zwroty ręcznie, udokumentuj liczbę kroków i osobę odpowiedzialną. Zwrot bez śladu audytowego szybko zamienia się w długie popołudnie.
7. Przetestuj checkout Payora od koszyka do opłaconego zamówienia
Przeprowadź co najmniej jeden pełny test od koszyka do opłaconego zamówienia. Użyj sandboxa, jeśli Payora go oferuje, albo kontrolowanego testu na żywo, jeśli zespół to zatwierdzi. Chcesz zobaczyć stronę checkoutu, instrukcje płatności, callback i zaktualizowany status zamówienia w panelu Admin.
Zacznij od produktu niskiego ryzyka. Dodaj go do koszyka, przejdź przez checkout i obserwuj, czy metoda płatności pojawia się dokładnie tam, gdzie tego oczekujesz. Jeśli Payora się nie pokazuje, problemem zwykle jest flaga konfiguracji, niezgodność waluty albo ustawienie widoku sklepu.
Następnie obserwuj stronę administracyjną. Udany test powinien spowodować zmianę statusu, a często także utworzenie faktury lub wpisu płatności. Jeśli sklep pokazuje „opłacone”, ale Magento nadal mówi „oczekuje”, zatrzymaj się i sprawdź log callbacku, zanim spróbujesz ponownie.
Przetestuj też jeden scenariusz wygaśnięcia. Pozwól, aby okno płatności minęło, i potwierdź, że zamówienie nie pozostaje na zawsze w stanie nieukończonym. Martwe zamówienia szybko się mnożą, a zespoły wsparcia nienawidzą sprzątania ich pojedynczo.
Jeśli Twój zespół obsługuje więcej niż jedną platformę, logika checkoutu może wydawać się znajoma. Proces w akceptowaniu płatności kryptowalutowych w WordPressie korzysta z podobnych kontroli potwierdzenia, choć obsługa administracyjna w Magento ma własny charakter.
8. Rozwiązywanie typowych problemów z połączeniem w Magento
Najczęstsze blokery nie są efektowne. Zły adres callbacku. Brak aktywacji modułu. Niezgodność waluty. Wyłączona metoda płatności w niewłaściwym widoku sklepu. Każdy z tych problemów daje inne objawy i każdy da się naprawić, gdy przestaniesz zakładać, że uszkodzona jest bramka.
Jeśli callbacki nigdy nie przychodzą, przetestuj endpoint bezpośrednio i potwierdź, że serwer akceptuje żądania przychodzące z konfiguracji środowiska Payora. Reguła firewall może blokować wszystko, podczas gdy panel Magento nadal wygląda zdrowo. To najgorszy rodzaj „zdrowia”.
Jeśli metoda płatności pojawia się w panelu Admin, ale nie w checkoutcie, sprawdź reguły widoczności i warunki koszyka. Niektóre sklepy ukrywają metody płatności według wartości koszyka, kraju wysyłki albo grupy klientów. Jedna ukryta reguła wystarczy, żeby Payora zniknęła.
Jeśli synchronizacja statusu płatności się opóźnia, sprawdź ponownie mapowanie stanów zamówienia i porównaj je z odpowiedzią bramki. Kod może być poprawny, ale sklep może czekać na wartość statusu, której Payora w ogóle nie wysyła. Taka niezgodność jest częsta w projektach konfiguracji bramki płatności Magento, gdzie pierwsza konfiguracja została skopiowana z innego sklepu i nigdy nie została uporządkowana.
W przypadku nazw pól API, zachowania endpointów i formatów żądań zależnych od sklepu, trzymaj stronę dokumentacja deweloperska, API bramki płatności kryptowalutowych otwartą podczas diagnozowania. Brak jednego parametru może zatrzymać cały proces.
Oto praktyczna checklista, którą możesz przejść w 10 minut:
- Potwierdź, że moduł Payora jest włączony we właściwym widoku sklepu Magento.
- Sprawdź, czy adres webhooka lub callbacku odpowiada środowisku produkcyjnemu.
- Upewnij się, że dozwolone waluty obejmują walutę checkoutu.
- Potwierdź, że mapowanie statusów zamówienia zgadza się z rzeczywistymi wartościami odpowiedzi Payora.
- Złóż jedno testowe zamówienie i obserwuj aktualizacje zarówno w sklepie, jak i w panelu Admin.
Jeśli sklep ma wielu administratorów, ogranicz osoby mogące zmieniać ustawienia płatności. Dwie osoby edytujące tę samą bramkę tego samego dnia to najprostszy sposób, by „tymczasowe” poprawki stały się trwałymi błędami. Utrzymuj jednego właściciela albo przynajmniej jedną osobę zatwierdzającą.
Magento jest restrykcyjne, ale to potrafi pomagać. Gdy moduł jest zainstalowany, ustawienia kompletne, a callbacki zweryfikowane, Payora działa przewidywalnie w checkoutcie, a dokładnie tego większość sprzedawców oczekuje od metody płatności.
Comments