PayU w WooCommerce - konfiguracja krok po kroku

Potrzebujesz dostępu do sklepu, aktywnego procesu rejestracji u operatora oraz osoby, która może sprawdzić punkt płatności. Konto i rachunek rozliczeniowy powinny pozostać pod kontrolą właściciela firmy. Nie przekazuj haseł przez publiczne zgłoszenie ani nie zapisuj sekretów w dokumencie dostępnym całemu zespołowi.

Przygotuj kopię plików i bazy, a zmiany rozpocznij na stagingu. Samo skopiowanie sklepu nie izoluje go od produkcji: sprawdź dane operatora, automatyczne odnowienia, integracje realizujące zamówienia i wysyłkę wiadomości. Kopia nie może przypadkowo wykonać rzeczywistego pobrania ani obsłużyć zamówienia klienta.

Zapisz wersje WordPressa, WooCommerce, modułu oraz rodzaj checkoutu. Ustal też, które metody mają działać na początku. To pozwoli rozpoznać, czy problem dotyczy całej integracji, czy tylko jednej konfiguracji. Jeżeli nie potrafisz potwierdzić izolacji testów lub nie masz możliwości odtworzenia sklepu, zatrzymaj konfigurację i przygotuj środowisko przed zmianą ustawień płatniczych.

Oficjalne repozytorium PayU wskazuje nazwę PayU GPO Payment for WooCommerce; w polskiej dokumentacji występuje PayU GPO Payment dla WooCommerce. Zweryfikuj wydawcę i odnośnik do produktu, zamiast wybierać pierwszą podobnie nazwaną wtyczkę. Moduł wymaga punktu płatności typu REST API oraz dwóch rozszerzeń PHP: cURL i hash.

Zainstaluj i aktywuj wtyczkę z właściwego źródła. Przed kontynuowaniem sprawdź zgodność jej aktualnej wersji z używanym checkoutem i rozszerzeniami sklepu. Informacja o obsłudze bloków w bieżącej dokumentacji nie jest gwarancją współpracy z każdym dodatkiem zmieniającym formularz zamówienia.

Jeśli w sklepie działa już inna integracja PayU, najpierw ustal, jakie zamówienia i procesy obsługuje. Nie podmieniaj jej w produkcji bez planu dla rozpoczętych płatności i zwrotów. Płatny moduł może oferować inne funkcje lub wsparcie, ale cena licencji sama nie potwierdza niższej prowizji operatora.

Dane globalne ustawisz w WooCommerce > Ustawienia PayU. Zgodnie z polską dokumentacją modułu obejmują identyfikator punktu, drugi klucz MD5 oraz dane OAuth client_id i client_secret. Sandbox ma osobny zestaw pól. Identyfikator wskazuje punkt; sekretów nie należy kopiować do zrzutów ekranu ani zgłoszeń.

Przy wybranej metodzie ustaw Tryb sandbox i sprawdź opcję Użyj wartości globalnych. Nie utożsamiaj wpisania danych testowych z przełączeniem wszystkich metod naraz. Jeżeli metoda ma własne parametry, skontroluj również ich pochodzenie.

Dokumentacja sandbox PayU prowadzi do środowiska secure.snd.payu.com. Korzystaj z jej aktualnych scenariuszy i rozdziel konto testowe od produkcyjnego. Sandbox nie służy do testów obciążeniowych; nadmierny ruch może otrzymać HTTP 429. Przy błędzie autoryzacji najpierw porównaj tryb, punkt i kompletność danych, nie ponawiaj masowo tych samych prób.

W ustawieniach metod sprawdź ich aktywność, widoczną nazwę i używane dane punktu. Dostępność zależy także od tego, co włączono po stronie PayU. Oceniaj warianty na przykładowym koszyku z właściwą walutą, dostawą i typem produktu.

README modułu podaje ważne rozróżnienia: PayU standard i lista banków są alternatywami, podobnie karta płatnicza i secure form. Nie włączaj obu wariantów tej samej pary. Oficjalna metoda BLIK przekierowuje do strony BLIK; funkcja kodu wpisywanego bezpośrednio w sklepie w API nie dowodzi jej obecności w tym module.

Google Pay wymaga weryfikacji sklepu i identyfikatora sprzedawcy. Apple Pay wymaga zarejestrowanej domeny zgodnej z domeną checkoutu. Nie pomijaj tych etapów po aktywacji kart. Przy braku metody sprawdź ograniczenia punktu, kwoty oraz ustawień dostawy i zamówień wirtualnych. Szerszy kontekst opisuje poradnik BLIK w WooCommerce.

PayU przekazuje informację o płatności niezależnie od powrotu klienta. Adres notifyUrl odbiera powiadomienia serwerowe, a continueUrl służy powrotowi przeglądarki. Nie wpisuj jednego w miejsce drugiego i nie twórz własnej ścieżki callbacku, jeśli używany moduł zarządza nią sam.

Cykl płatności PayU opisuje cztery statusy: PENDING, WAITING_FOR_CONFIRMATION, COMPLETED i CANCELED. Odbiorca sprawdza podpis OpenPayu-Signature i potwierdza odbiór HTTP 200. Powiadomienie może zostać ponowione, dlatego integracja musi tolerować duplikaty. Ręczna zmiana statusu sklepu nie naprawia tego mechanizmu.

W WooCommerce opłacone zamówienie może oczekiwać realizacji jako Processing. Nie musi od razu przejść do Completed. Dokumentacja WooCommerce wskazuje wyjątek dla zamówień zawierających wyłącznie produkty jednocześnie wirtualne i do pobrania. Przed uznaniem statusu za błąd porównaj rodzaj produktu, ustawienia modułu oraz rzeczywisty stan płatności u operatora. Nie wysyłaj towaru wyłącznie na podstawie ekranu podziękowania.

Osoba wykonująca testy powinna zapisać wynik po stronie sklepu i operatora. Scenariusze sandbox dobierz do dokumentacji używanej metody, zamiast stosować jeden kod i jeden oczekiwany status do wszystkich płatności.

WooCommerce wyjaśnia: "Directly changing an order's status to Cancelled or Refunded will not automatically refund your customer." Źródło: dokumentacja zwrotów. Aby wysłać refundację, użyj funkcji zwrotu przez daną bramkę, jeśli moduł ją obsługuje, i zweryfikuj rezultat. Zwrot ręczny oraz status Zwrócone nie są dowodem wysłania pieniędzy. Przy niejasnym wyniku nie ponawiaj operacji, zanim nie sprawdzisz panelu operatora i notatek zamówienia.

Zanotuj czas, metodę, identyfikator zamówienia i płatności oraz to, w którym miejscu pojawia się problem. Dane klientów i sekrety usuń z materiału przekazywanego w zgłoszeniu. Logi włączaj w zakresie potrzebnym do diagnozy, a po zakończeniu pracy ogranicz ich gromadzenie.

FAQ techniczne PayU pomaga diagnozować dostarczenie powiadomień. Jeśli blokuje je firewall, ustal konkretną regułę. Nie wyłączaj globalnie ochrony ani weryfikacji podpisu. Obsługa powtórzeń należy do mechanizmu integracji. Przy niepewnym obciążeniu lub zwrocie przerwij próby i wyjaśnij wynik z operatorem.

Przed uruchomieniem sprawdź aktywację konta i potrzebnych metod. W produkcji zastosuj dane właściwego punktu i skontroluj tryb każdej metody. Nie przenoś automatycznie wszystkich ustawień ze stagingu. Zachowaj opis poprzedniej konfiguracji oraz plan reakcji, jeśli nowe zamówienia nie otrzymają poprawnych statusów.

Przekaż właścicielowi dostęp do konta, instrukcję obsługi zwrotów i dane kontaktowe wsparcia. Ustal, kto kontroluje integrację po aktualizacji sklepu. Dla kolejnych zmian przyda się lista kryteriów odbioru bramki.

Prowizje sprawdzisz w poradniku kosztów PayU; nie wynikają one z samej instalacji wtyczki. Podstawowe wdrożenie płatności od 1499 zł netto dotyczy istniejącego WooCommerce z PayU, P24 lub Tpay. Naprawę i szerszy zakres ustalamy po diagnozie. Przy problemie z WordPressem napisz do nas, podając adres lub platformę i objaw. Dodatkowe informacje o module możesz uzupełnić podczas rozmowy.

Płatności i wysyłkę konfigurujemy przed startem, gdy realizujemy wdrożenie sklepu WooCommerce dla nowej firmy.

• Jak uruchomić integrację z PayByLink w sklepie WooCommerce
• Integracja Worldpay ze sklepem WooCommerce krok po kroku
• Jak ręcznie dodać wpłatę do zamówienia w panelu WooCommerce
• Sprzedaż w wielu walutach w WooCommerce z voucherami