PayU w WooCommerce – konfiguracja krok po kroku

PayU obsługuje ponad 300 000 sklepów internetowych w Polsce i przetwarza więcej transakcji niż jakikolwiek inny operator. Obsługuje BLIK, szybkie przelewy, karty płatnicze, raty, Apple Pay i Google Pay – praktycznie wszystko, czego polscy klienci oczekują przy finalizacji zamówienia.

Dla właściciela sklepu WooCommerce to oznacza, ze jedna integracja daje dostęp do kilkunastu metod płatności. Nie musisz instalować osobnych wtyczek do BLIK-a, kart i przelewów.

Zakładanie konta – wymagane dokumenty

Wejdź na payu.pl i załóż konto firmowe. Przygotuj: NIP, numer rachunku bankowego firmowego, dane rejestrowe (CEIDG lub KRS). Weryfikacja trwa zazwyczaj 1–2 dni robocze, choć w okresach wzmożonego ruchu (np. Przed Black Friday) może się wydłużyć do 3–5 dni.

Gdzie znaleźć klucze API

Po aktywacji konta przejdź do panelu PayU: Moje sklepy > Punkty płatności. Dla każdego punktu PayU generuje cztery klucze:

• POS ID – identyfikator punktu płatności
• Klucz MD5 (Second Key) – do podpisywania zadan
• Client ID – do autoryzacji OAuth 2.0
• Client Secret – druga część autoryzacji OAuth

Zapisz te dane w bezpiecznym miejscu. PayU pozwala utworzyć osobne punkty płatności dla środowiska testowego (sandbox.payu.com) i produkcyjnego (secure.payu.com). Klucze nie sa zamienne między środowiskami – to najczęstsze źródło błędu 401 Unauthorized.

Oficjalna wtyczka PayU (darmowa) vs WP Desk (platna)

PayU SA udostępnia darmowa wtyczkę WooCommerce PayU w repozytorium WordPress. Obsługuje BLIK, przelewy, karty i raty. Instalacja jest prosta, ale interfejs ustawień jest minimalistyczny.

Alternatywa to platna wtyczka od WP Desk (Octolize) – kosztuje około 300 PLN/rok, ale oferuje nizsza prowizje (1,2% bez stałej opłaty vs standardowe 2,45% + 0,35 PLN), rozbudowane ustawienia i lepsza obsługę techniczna.

Dla większości sklepów oficjalna wtyczka wystarczy. Platna wersja WP Desk opłaca się przy więcej niż 100 transakcjach miesięcznie – wtedy nizsza prowizja szybko zwraca koszt licencji.

Instalacja krok po kroku

1. W panelu WordPressa przejdź do Wtyczki > Dodaj nowa
2. Wyszukaj WooCommerce PayU (autor: PayU SA)
3. Kliknij Zainstaluj, potem Włącz
4. Przejdź do WooCommerce > Ustawienia > Płatności

Po aktywacji zobaczysz kilka nowych metod: PayU – standardowa płatność, PayU – BLIK, PayU – raty, PayU – karty. Kazda włączasz lub wyłączasz niezależnie.

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
• Client Secret – druga część OAuth

Zaznacz opcje Tryb testowy (sandbox). W trybie sandbox symulujesz płatności bez realnych pieniędzy – PayU udostępnia testowe numery kart i kody BLIK w dokumentacji developerskiej.

Częsty błąd: wklejenie kluczy produkcyjnych do trybu sandbox (lub odwrotnie). Klucze sa przypisane do środowiska. Drugi typowy problem – niewidoczna spacją na końcu klucza po skopiowaniu z panelu. Jeśli widzisz 401 Unauthorized, zacznij od tego.

Po podlaczeniu PayU masz dostęp do pełnej gamy metod płatności. Kazda aktywujesz osobno w panelu PayU (nie w WooCommerce).

BLIK – najpopularniejsza metoda (65% transakcji online w Polsce). Więcej o konfiguracji w artykule o BLIK w WooCommerce.

Karty płatnicze – Visa, Mastercard, obsluga 3D Secure. Prowizja standardowa: 2,45% + 0,35 PLN (lub 1,2% przez WP Desk).

Szybkie przelewy – przekierowanie do banku klienta. Prowizja BLIK-owa (1,19% + 0,09 PLN).

PayU Raty – klient rozkłada płatność na raty (3, 6, 12 lub 24 miesiące). Wymagania: zamówienie powyżej 300 PLN, aktywacja w panelu PayU. Prowizja wliczona w koszt rat – sprzedawca dostaje pelna kwotę.

Apple Pay i Google Pay – dostępne automatycznie po aktywacji kart płatniczych. Nie wymagają osobnej konfiguracji.

Standardowe stawki (oficjalna wtyczka):

• Szybkie przelewy / BLIK: 2,45% + 0,35 PLN
• Karty płatnicze: 2,45% + 0,35 PLN

Stawki przez WP Desk (platna wtyczka):

• Szybkie przelewy / BLIK: 1,2% (bez stałej opłaty)
• Karty: 1,2% (bez stałej opłaty)

Kalkulacja dla 500 transakcji miesięcznie przy średnim zamówieniu 120 PLN:

• Oficjalna wtyczka: 500 x (120 x 2,45% + 0,35) = 1 645 PLN/mc
• WP Desk: 500 x (120 x 1,2%) = 720 PLN/mc
• Różnica: 925 PLN miesięcznie, 11 100 PLN rocznie

Przy 100 transakcjach różnica wynosi 185 PLN/mc – licencja WP Desk (300 PLN/rok) zwraca się już w drugim miesiącu.

Czas wypłaty środków: T+1 (następny dzień roboczy) dla weryfikowanych sprzedawców, T+3 dla nowych kont. Wypłaty sa darmowe od pewnego progu obrotów – szczegóły ustalasz z opiekunem PayU.

Potrzebujesz pomocy z doborem bramki płatności? Sprawdź naszą ofertę budowy sklepów internetowych.

Przed wyłączeniem sandbox przejdź przez te scenariusze:

1. Udana płatność – zamówienie zmienia status na "Przetwarzane" automatycznie
2. Odrzucona płatność – zamówienie wraca do "Oczekujące na płatność"
3. Zwrot – zmień status na "Zwrócone" i sprawdź, czy PayU potwierdza zwrot w panelu
4. Timeout – nie potwierdzaj płatności BLIK w ciągu 2 minut, sprawdź czy zamówienie się anuluje

Checklist przed przejściem na produkcję:
- Klucze produkcyjne (nie sandbox!) wklejone poprawnie
- Callback URL ustawiony na pełny adres HTTPS
- Email z potwierdzeniem zamówienia wysyła się poprawnie
- Strona "Dziękujemy za zamówienie" działa

Błąd 401 Unauthorized

Niezgodność kluczy ze środowiskiem. Klucze sandbox nie działają w trybie produkcyjnym i odwrotnie. Skopiuj klucze ponownie – czasem dodaje się niewidoczna spacją.

Notyfikacje PayU nie dochodzą do WooCommerce

Sprawdź, czy serwer nie blokuje połączeń przychodzących od PayU. Adresy IP PayU muszą być na whiteliście firewalla. Sprawdź też, czy callback URL w ustawieniach wtyczki jest poprawny i dostępny z zewnątrz.

Podwójne zamówienia

Klient klika "Zapłać" dwa razy, bo strona ładuje się wolno. Rozwiązanie: włącz blokadę przycisku po kliknięciu (większość nowoczesnych motywów WooCommerce robi to domyślnie) i sprawdź mechanizm idempotentnosci w ustawieniach wtyczki.

Problem z SSL / mixed content

PayU wymaga HTTPS. Jeśli sklep ma mieszana treść (HTTP + HTTPS), bramka płatności może się nie załadować. Sprawdź certyfikat SSL i wymuś przekierowanie całej witryny na HTTPS.

Masz problem z integracjami płatności WooCommerce? Skontaktuj się z nami – pomagamy sklepom uruchomić płatności online szybko i bezboledsnie.