PayU w WooCommerce – konfiguracja krok po kroku

Zanim dotkniesz WooCommerce, potrzebujesz aktywnego konta w PayU. Wejdź na payu.pl i załóż konto firmowe – przygotuj NIP, numer konta bankowego i dane rejestrowe firmy. Weryfikacja trwa zazwyczaj 1-2 dni robocze.

Po aktywacji konta przejdź do panelu PayU i znajdź sekcję Moje sklepy > Punkty płatności. Dla każdego punktu PayU generuje zestaw kluczy:

• POS ID (identyfikator punktu płatności)
• Klucz MD5 (drugi klucz do podpisywania żądań)
• Client ID i Client Secret (do autoryzacji OAuth)

Zapisz te dane w bezpiecznym miejscu. PayU pozwala utworzyć osobne punkty płatności dla środowiska testowego (sandbox) i produkcyjnego – koniecznie skonfiguruj oba.

PayU udostępnia oficjalną wtyczkę WooCommerce PayU w repozytorium WordPress. Instalacja przebiega standardowo:

1. W panelu WordPress przejdź do Wtyczki > Dodaj nową
2. Wyszukaj WooCommerce PayU (autor: PayU SA)
3. Kliknij Zainstaluj, a potem Włącz

Alternatywnie pobierz wtyczkę ze strony PayU i wgraj ręcznie przez FTP do katalogu `/wp-content/plugins/`.

Po aktywacji wtyczka pojawi się w WooCommerce > Ustawienia > Płatności. Zobaczysz kilka nowych metod: PayU – standardowa płatność, PayU – BLIK, PayU – raty, PayU – karty. Każdą włączasz lub wyłączasz niezależnie. Jeśli dopiero budujesz sklep na WooCommerce, PayU to solidny wybór na start.

Przejdź do WooCommerce > Ustawienia > Płatności > PayU i uzupełnij formularz kluczami z panelu PayU:

• POS ID – identyfikator punktu płatności
• Drugi klucz (MD5) – do weryfikacji podpisu transakcji
• Client ID – do autoryzacji OAuth 2.0
• Client Secret – druga część autoryzacji OAuth

Koniecznie zaznacz opcję Tryb testowy (sandbox). Sandbox działa na osobnym środowisku – `secure.snd.payu.com` zamiast `secure.payu.com`. W trybie testowym symulujesz płatności bez realnych pieniędzy, korzystając z testowych numerów kart i kodów BLIK z dokumentacji PayU.

Częsty błąd: wklejenie kluczy produkcyjnych do trybu sandbox (lub odwrotnie). Klucze nie są zamienne między środowiskami. Błąd 401 Unauthorized to prawie zawsze problem z niezgodnością kluczy i trybu.

PayU w 2026 roku oferuje kilka metod płatności, które aktywujesz w WooCommerce niezależnie:

• BLIK – absolutny must-have. Ponad 70% polskich transakcji online przechodzi przez BLIK
• Karty płatnicze – Visa, Mastercard z obsługą 3D Secure. Przydatne przy klientach zagranicznych
• Szybkie przelewy bankowe – pay-by-link do większości polskich banków
• Raty PayU – płatność ratalna online, PayU przejmuje ryzyko kredytowe. Sprawdza się przy produktach powyżej 300 zl
• Google Pay i Apple Pay – coraz popularniejsze na urządzeniach mobilnych

W ustawieniach wtyczki wybierasz, czy klient widzi listę metod bezpośrednio na stronie sklepu, czy zostaje przekierowany na stronę PayU. Pierwszy wariant (widget) wygląda profesjonalniej i zmniejsza liczbę porzuconych koszyków. Porównujesz operatorów? Sprawdź zestawienie Stripe vs PayU.

Nie pomijaj testów – na tym etapie wyłapiesz 90% problemów. W trybie sandbox przeprowadź następujące scenariusze:

1. Udana płatność – złóż testowe zamówienie, opłać je i sprawdź, czy status zmieni się na Przetwarzane
2. Odrzucona płatność – sandbox pozwala symulować odmowę. Upewnij się, że WooCommerce poprawnie wraca do koszyka z komunikatem o błędzie
3. Powiadomienia (notyfikacje) – PayU wysyła notyfikacje HTTP na adres Twojego sklepu. Sprawdź logi: WooCommerce > Status > Logi
4. Zwrot – zainicjuj zwrot z panelu WooCommerce i sprawdź, czy trafia do PayU

Częsty problem: notyfikacje nie dochodzą, bo serwer blokuje żądania z zewnątrz (firewall lub wtyczka bezpieczeństwa). Dodaj adresy IP PayU do białej listy. Po udanych testach wyłącz sandbox, wpisz klucze produkcyjne i wykonaj jedną realną transakcję za symboliczną kwotę.

Koszty to zawsze gorący temat. W 2026 roku standardowe stawki PayU dla sklepów internetowych prezentują się tak:

• Przelewy online i BLIK – od 1,19% + 0,25 zl za transakcję (obrót do 100 tys. zl/mies.)
• Karty płatnicze – od 1,39% + 0,25 zl za transakcję
• Raty PayU – prowizja indywidualna, zwykle 2-4%
• Wypłata na konto – 1 dzień roboczy, bez dodatkowej opłaty

Przy wyższych obrotach PayU negocjuje stawki indywidualnie – różnica 0,2 pp. robi sporą różnicę przy dużym wolumenie. PayU nie zwraca prowizji od zwróconych transakcji, co warto uwzględnić w kalkulacji marż. Więcej o kosztach bramek w artykule o kosztach Tpay.

Przez lata konfigurowania PayU w sklepach klientów zebrałem listę problemów, które powtarzają się najczęściej:

Błąd 401 Unauthorized – niezgodność kluczy API z trybem (sandbox vs produkcja). Sprawdź, czy wpisałeś klucze odpowiadające aktywnemu trybowi.

Zamówienia utknęły na statusie Oczekuje na płatność – notyfikacje nie dochodzą. Zweryfikuj Notify URL w panelu PayU i upewnij się, że serwer nie blokuje żądań POST.

Brak metody BLIK na liście – BLIK musisz aktywować osobno w panelu PayU, w ustawieniach punktu płatności. Samo włączenie wtyczki nie wystarczy.

Przekierowanie na stronę 404 po płatności – problem z permalinkami. Przejdź do Ustawienia > Bezpośrednie odnośniki i zapisz ponownie bez zmian. Jeśli nadal masz trudności z konfiguracją, skontaktuj się z nami – pomożemy uruchomić płatności.