Integracja PayU WooCommerce łączy sklep z bramką płatniczą i automatycznie przekazuje informacje o opłaconych zamówieniach. Klient wybiera wygodną metodę, płaci, a Ty widzisz aktualny status w panelu sklepu.
Jak działa integracja PayU WooCommerce
Oficjalna wtyczka PayU łączy WooCommerce z bramką płatniczą. Klient może zapłacić BLIK-iem, kartą, Google Pay, przelewem, na raty lub przez usługę „płacę później”, a status zamówienia aktualizuje się automatycznie.
Po wybraniu płatności sklep przekazuje dane zamówienia do PayU. Dalszy przebieg zależy od metody: klient może zostać przekierowany na stronę operatora albo dokończyć płatność bezpośrednio w checkoucie. Po potwierdzeniu transakcji PayU wysyła informację do WooCommerce.
Wtyczka pozwala wyświetlić jedną zbiorczą metodę „PayU – standard”. Klient przechodzi wtedy do strony PayU i dopiero tam wybiera BLIK, kartę, przelew lub inną dostępną opcję.
Możesz też pokazać poszczególne metody jako osobne pozycje w checkoucie. Oficjalny moduł obsługuje między innymi BLIK, kartę, Google Pay, raty, PayPo i Twisto. Dostępność każdej z nich zależy również od konfiguracji Twojego punktu płatności w PayU.
Po swojej stronie otrzymujesz panel z listą transakcji. Sprawdzisz w nim płatności, zlecisz zwrot i skontrolujesz wypłaty środków. Zamówieniami nadal zarządzasz w WooCommerce, więc codzienna obsługa sklepu pozostaje w jednym miejscu.
Zanim zaczniesz – konto PayU i punkt płatności typu REST API
Do uruchomienia PayU WooCommerce potrzebujesz konta produkcyjnego oraz punktu płatności typu REST API. Wtyczka wymaga czterech danych: pos_id, drugiego klucza MD5, client_id i client_secret.
Konto produkcyjne zakładasz w PayU. Podczas rejestracji podajesz dane firmy, rachunek bankowy i informacje o sklepie. Operator przeprowadza później weryfikację działalności. Sklep powinien być wtedy kompletny – z regulaminem, polityką prywatności i działającym checkoutem. Jeśli dopiero go stawiasz, przejdź najpierw przez nasz przewodnik jak założyć sklep internetowy na WordPressie.
W trakcie pełnej weryfikacji możesz już przyjmować płatności przelewem oraz BLIK-iem do limitu 2500 zł. Dzięki temu da się wcześniej uruchomić sprzedaż i sprawdzić podstawową obsługę zamówień. Pełny zestaw usług będzie dostępny po zakończeniu procesu.
Po utworzeniu sklepu w panelu PayU dodaj punkt płatności i upewnij się, że jego typ to REST API. Moduł WooCommerce nie obsłuży punktu utworzonego w innym standardzie. To częsta przyczyna problemów z połączeniem, zwłaszcza gdy konto PayU było wcześniej używane przez starszy sklep. Szczegóły techniczne znajdziesz w dokumentacji wtyczek PayU.
W ustawieniach punktu znajdziesz cztery dane potrzebne do konfiguracji. pos_id identyfikuje punkt płatności. Drugi klucz MD5 służy do sprawdzania poprawności komunikacji. Para client_id i client_secret pozwala wtyczce uwierzytelnić się w PayU.
Skopiuj wartości bez dodatkowych spacji i przechowuj je jak hasło. client_secret oraz klucz MD5 dają dostęp do ważnych operacji związanych z płatnościami, dlatego nie powinny trafiać do publicznego zgłoszenia, wiadomości na forum ani zrzutu ekranu.
Konfiguracja PayU w WooCommerce krok po kroku
Konfiguracja PayU w WooCommerce sprowadza się do instalacji oficjalnego modułu, wpisania czterech danych i wybrania metod płatności. Na końcu trzeba złożyć zamówienie testowe i sprawdzić cały przepływ od koszyka do zmiany statusu.
Krok 1. Zainstaluj wtyczkę PayU z katalogu WordPressa
Zaloguj się do panelu WordPressa i przejdź do sekcji z dodawaniem wtyczek. W wyszukiwarce wpisz „PayU GPO Payment for WooCommerce”, czyli oficjalny moduł PayU w katalogu WordPressa. Sprawdź nazwę autora, zainstaluj moduł i włącz go.
Wtyczka PayU wymaga PHP w wersji 7.4 lub nowszej oraz biblioteki cURL. cURL odpowiada za komunikację sklepu z serwerami operatora. Zwykle jest już dostępny na hostingu, a jego stan sprawdzisz w informacjach o środowisku WordPressa lub u dostawcy serwera.
Po aktywacji przejdź do ustawień WooCommerce, otwórz zakładkę płatności i znajdź metody oznaczone nazwą PayU. Ich liczba zależy od wersji modułu i usług dostępnych na Twoim koncie.
Krok 2. Wpisz dane punktu płatności (pos_id, drugi klucz, OAuth)
Otwórz ustawienia podstawowej bramki PayU. W odpowiednie pola wklej pos_id, drugi klucz MD5, OAuth client_id oraz OAuth client_secret.
Wszystkie cztery wartości muszą pochodzić z jednego punktu płatności i jednego środowiska. Dane z konta produkcyjnego łączysz z trybem produkcyjnym. Dane testowe działają w sandboxie.
Po zapisaniu ustawień sprawdź, czy WooCommerce nie wyświetla komunikatu o błędnym uwierzytelnieniu. Jeśli połączenie nie działa, porównaj każdą wartość z panelem PayU. Szczególną uwagę zwróć na drugi klucz MD5 oraz client_secret, ponieważ oba mają podobną postać i łatwo wkleić je w odwrotnej kolejności.
Krok 3. Wybierz metody płatności widoczne w checkoucie
Najprostszy wariant to jedna metoda „PayU – standard”. Klient widzi pojedynczą pozycję, przechodzi do PayU i wybiera sposób zapłaty na stronie operatora. Taka konfiguracja daje krótki, przejrzysty checkout.
Osobne pozycje skracają drogę do popularnych płatności. Klient może od razu kliknąć BLIK, kartę lub Google Pay. Ma to sens, gdy znasz preferencje kupujących i chcesz wyeksponować dwie lub trzy najczęściej używane opcje.
Nie musisz włączać wszystkiego, co oferuje moduł. Długa lista banków, kart, rat i płatności odroczonych zajmuje sporo miejsca, szczególnie na telefonie. Zacznij od metod najważniejszych dla Twoich klientów, a pozostałe zostaw pod zbiorczą opcją PayU.
Kolejność ustawisz w sekcji płatności WooCommerce. Najczęściej wybieraną metodę umieść wysoko, najlepiej w pobliżu przesyłek i podsumowania ceny. Po zmianie układu otwórz checkout na telefonie i sprawdź, czy nazwy są czytelne, a pola nie przesuwają przycisku zamówienia daleko w dół strony.
Krok 4. Złóż zamówienie testowe i sprawdź zmianę statusu
Dodaj tani produkt testowy do koszyka i przejdź pełną ścieżkę zakupu. Wybierz PayU, rozpocznij płatność i sprawdź, czy sklep przekierowuje Cię do właściwego środowiska.
Po udanej transakcji wróć do zamówienia w WooCommerce. Jego status powinien zmienić się zgodnie z konfiguracją sklepu, zwykle z „Oczekuje na płatność” na „W trakcie realizacji”. Przy produktach wirtualnych WooCommerce może od razu zakończyć zamówienie.
Skontroluj również wiadomości e-mail, stan magazynowy i zapis transakcji w panelu PayU. Strona z podziękowaniem potwierdza tylko powrót ze strony operatora. Pełny obraz daje dopiero komplet: płatność, potwierdzenie operatora, zmiana statusu i poprawna obsługa zamówienia.
Sandbox PayU – osobne konto testowe
Sandbox PayU jest oddzielnym środowiskiem z własnym kontem, panelem i danymi POS. Produkcji nie przełącza się w tryb testowy jednym suwakiem w panelu PayU.
Do własnych testów możesz utworzyć osobne konto sandbox. Po rejestracji dodajesz testowy sklep oraz punkt płatności, a następnie pobierasz jego pos_id, drugi klucz MD5, client_id i client_secret. PayU udostępnia również publiczny punkt testowy, ale własne konto daje dostęp do panelu i pozwala prześledzić transakcje.
W pierwszym scenariuszu wykonaj udaną płatność i sprawdź zmianę statusu. Następnie anuluj płatność przed jej zakończeniem. Na koniec przeprowadź zwrot z panelu PayU i zobacz, czy kwota oraz status zgadzają się z zamówieniem.
Po testach wprowadź do wtyczki komplet danych produkcyjnych i wyłącz tryb sandbox. Wyczyść pamięć podręczną, otwórz checkout w nowym oknie i upewnij się, że adres płatności prowadzi do środowiska produkcyjnego.
Typowe błędy przy integracji i jak je naprawić
Problemy z PayU WooCommerce najczęściej wynikają z ustawień punktu płatności, pomieszania danych albo blokady powiadomień. Zacznij od sprawdzenia środowiska i wszystkich czterech pól, a dopiero później szukaj konfliktu w kodzie sklepu.
Pierwszy podejrzany to typ punktu płatności. Jeśli w panelu widzisz standard inny niż REST API, utwórz lub skonfiguruj właściwy punkt i skopiuj jego dane do WooCommerce.
Często mieszają się też produkcja i sandbox. Cztery pola mogą wyglądać poprawnie, choć pochodzą z dwóch różnych paneli. Najbezpieczniej skopiować cały komplet jeszcze raz, bez korzystania ze starej wiadomości lub notatki.
Płatność czasem przechodzi, lecz zamówienie nadal oczekuje na zapłatę. W takiej sytuacji PayU mogło wysłać powiadomienie, którego sklep nie przyjął. Sprawdź reguły firewalla, zabezpieczenia hostingu oraz pamięć podręczną. Adresy obsługujące powiadomienia o płatności powinny być wyłączone z cache, czyli mechanizmu zapisującego gotową wersję strony.
Kolejny punkt to waluta. Waluta zamówienia w WooCommerce musi być obsługiwana przez dany punkt PayU i aktywną metodę płatności. Problem może pojawić się po instalacji przelicznika walut albo przy sprzedaży na kilku rynkach.
Jeżeli błąd zaczął się po aktualizacji lub instalacji kolejnego modułu płatniczego, wykonaj próbę na kopii sklepu z wyłączonymi pozostałymi bramkami. Konflikty zdarzają się również przy dodatkach modyfikujących checkout. Po znalezieniu winnego modułu sprawdź jego aktualizacje i zgodność z używaną wersją WooCommerce.
Prowizje PayU w praktyce
Oferta PayU dla małych i średnich firm przewiduje jednorazową rejestrację za 29 zł w promocji, przy cenie standardowej 199 zł. Do wyboru są dwa warianty prowizji: 0,30 zł plus 1,1% albo 1,49% wartości transakcji. Aktualne stawki i pełny cennik znajdziesz na stronie oferty PayU dla MSP.
Przy zamówieniu za 100 zł pierwszy wariant kosztuje 1,40 zł, a drugi 1,49 zł. Dla koszyka o wartości 50 zł będzie to odpowiednio 0,85 zł oraz około 0,75 zł. Granica wypada w okolicy 77 zł: poniżej tej kwoty korzystniej wygląda sama prowizja procentowa, a powyżej częściej wygrywa wariant z opłatą stałą i niższym procentem.
Taki rachunek wykonaj na podstawie średniej wartości koszyka, a nie ceny pojedynczego produktu. Sklep sprzedający akcesoria po 30 zł może mieć średnie zamówienie za 120 zł, jeśli klienci regularnie kupują kilka sztuk.
Raty 0% i usługi „płacę później” są rozliczane w tej samej stawce. Przy obrocie przekraczającym 800 tys. zł PayU przygotowuje ofertę indywidualną. Warunki promocji mogą się zmieniać, dlatego przed zawarciem umowy sprawdź aktualny cennik i zasady rozliczeń. Prowizje to tylko jedna pozycja w budżecie sklepu – pełne zestawienie kosztów znajdziesz w artykule ile kosztuje sklep internetowy.
PayU czy Przelewy24 – co wybrać do WooCommerce
PayU i Przelewy24 dobrze obsługują najpopularniejsze płatności WooCommerce, w tym szybkie przelewy, BLIK oraz karty. Wybór zwykle rozstrzygają szczegóły wdrożenia, cennik oraz sposób rozliczania wpłat przez księgowość.
Oficjalną wtyczkę PayU zainstalujesz bezpośrednio z katalogu WordPressa. Moduł Przelewy24 pobiera się ze strony operatora i wysyła do WordPressa jako paczkę. PayU wymaga pos_id, drugiego klucza MD5 oraz dwóch danych OAuth. W Przelewy24 spotkasz między innymi Merchant ID, POS ID, klucz CRC i klucz API – cały proces opisaliśmy w przewodniku po integracji Przelewy24 z WooCommerce.
Obaj operatorzy udostępniają środowiska testowe z osobnymi danymi. W PayU sandbox ma oddzielną rejestrację i własny panel, co trzeba uwzględnić podczas konfiguracji oraz późniejszego przejścia na produkcję.
Jeśli masz już aktywne konto u jednego operatora, migracja rzadko przyniesie dużą zmianę w wygodzie płacenia. Porównaj prowizję przy swojej średniej wartości zamówienia, terminy wypłat, raporty dla księgowości i dostępność potrzebnych metod. Te cztery rzeczy zwykle dają bardziej praktyczną odpowiedź niż sama lista logotypów w checkoucie.
FAQ
-
W ofercie dla małych i średnich firm do wyboru są dwa warianty: 0,30 zł + 1,1% albo 1,49% od transakcji. Rejestracja kosztuje jednorazowo 29 zł w promocji (standardowo 199 zł). Raty 0% i „płacę później” rozliczane są w tej samej stawce, a przy obrocie powyżej 800 tys. zł PayU przygotowuje ofertę indywidualną.
-
Moduł współpracuje wyłącznie z punktem płatności typu REST API. Jeśli Twoje konto ma punkt w starszym standardzie, dodaj w panelu PayU nowy punkt typu REST API i skopiuj jego dane do wtyczki.
-
Załóż osobne konto sandbox – testowe środowisko PayU ma własny panel i własne dane punktu płatności. Przejdź udaną płatność, anulowanie i zwrot, a po testach podmień komplet danych na produkcyjne i wyłącz tryb sandbox.
-
Najczęściej powiadomienie z PayU nie dociera do sklepu. Sprawdź reguły firewalla, zabezpieczenia hostingu i pamięć podręczną – adresy obsługujące powiadomienia o płatności powinny być wyłączone z cache. Porównaj też walutę i kwotę zamówienia z transakcją w panelu.
-
Tak. Obie metody możesz pokazać jako osobne pozycje w checkoucie albo zostawić pod zbiorczą opcją „PayU – standard”, gdzie klient wybiera sposób zapłaty na stronie operatora. Dostępność metod zależy od konfiguracji Twojego punktu płatności.