SiteFlow
Wszystkie wpisy
WOOCOMMERCE29 czerwca 2026 · aktualizacja 26 października 2026 · 4 min

PayU w WooCommerce: konfiguracja wtyczki, metody płatności, statusy zamówień i najczęstsze pułapki

PayU w WooCommerce: oficjalna wtyczka PayU GPO, punkt płatności typu REST API, klucze, sandbox, BLIK i raty, statusy zamówień i ponowienie płatności.

PayU łączy się z WooCommerce przez oficjalną wtyczkę „PayU GPO Payment for WooCommerce”, dostępną w katalogu WordPress.org i rozwijaną przez PayU. Instalacja zajmuje kilka minut, ale o tym, czy płatności będą działały bez niespodzianek, decydują trzy rzeczy: właściwy typ punktu płatności w panelu PayU, poprawne klucze i przemyślane statusy zamówień po nieudanej płatności. Poniżej opisuję konfigurację PayU w WooCommerce w tej kolejności.

Co obsługuje wtyczka PayU dla WooCommerce

  • Strona płatności PayU: klient przechodzi do PayU i wybiera dowolną metodę skonfigurowaną w punkcie płatności.
  • Metody osadzone w sklepie: lista banków, BLIK, formularz karty osadzony na stronie, Google Pay i Apple Pay jako osobne metody.
  • Raty i płatności odroczone: raty PayU, Klarna, PayPo, Twisto, a dla klientów firmowych PragmaPay.
  • Kasa w blokach: nowe, blokowe koszyk i kasa WooCommerce są obsługiwane przez większość metod.

Wtyczka wymaga WordPressa w wersji 5.0 lub nowszej i PHP 7.4 lub nowszego z bibliotekami cURL i hash. Najważniejsze wymaganie jest jednak po stronie PayU: moduł działa tylko z punktem płatności typu REST API.

PayU WooCommerce: konfiguracja krok po kroku

Od punktu płatności do pierwszej transakcji
  1. 1

    Punkt płatności REST API

    W panelu PayU utwórz punkt płatności typu REST API. Punkt innego typu nie zadziała z wtyczką, nawet jeśli klucze wyglądają poprawnie.

  2. 2

    Klucze do wtyczki

    Skopiuj z panelu PayU cztery wartości: identyfikator punktu (POS ID), drugi klucz MD5 oraz client_id i client_secret do protokołu OAuth.

  3. 3

    Konto sandbox

    Załóż osobne konto testowe PayU i wpisz jego cztery klucze w polach z prefiksem Sandbox. Produkcja i test mają osobne dane.

  4. 4

    Metody i statusy

    Włącz metody, które chcesz pokazać, i ustaw statusy zamówień po rozpoczęciu i po nieudanej płatności.

Klucze dają dostęp do płatności Twojego sklepu, więc traktuj je jak hasła: nie przesyłaj ich mailem otwartym tekstem i nie wklejaj w zgłoszeniach do pomocy technicznej.

Ustawienia globalne i ustawienia metod

Gdzie wpisujesz klucze PayU
Ustawienia globalneUstawienia metody
DomyślnieKażda metoda korzysta z globalnych kluczy punktuOpcja „Use global settings” włączona
Kiedy zmieniaćJeden punkt płatności dla całego sklepuOsobny punkt dla jednej metody, np. rat
Co jeszcze ustawiaszKlucze produkcyjne i testoweNazwa, opis, tryb sandbox, ograniczenie do metod dostawy, zamówienia wirtualne

Statusy zamówień i ponowienie płatności

Wtyczka pozwala wybrać status zamówienia po rozpoczęciu płatności („Wstrzymane” albo „Oczekujące na płatność”) i po płatności nieudanej („Anulowane” albo „Nieudane”). Ten drugi wybór ma praktyczne skutki: przy statusie „Nieudane” klient może ponowić płatność, a przy „Anulowane” zamówienie jest zamknięte i trzeba składać je od nowa. Dla większości sklepów lepszy jest status „Nieudane”, bo klient, któremu nie przeszedł BLIK, często próbuje drugi raz.

Przydatna jest też opcja sprawdzania statusu na stronie podziękowania. Gdy status płatności nie jest jeszcze ostateczny, wtyczka odpytuje go do 10 razy co 4 sekundy, więc klient częściej widzi „opłacone” zamiast „oczekuje”. Podstawą pozostają jednak powiadomienia z PayU do sklepu, bo to one zmieniają status, gdy klient zamknie okno. O tym, jak działa ten mechanizm w każdej bramce, piszę w tekście o tym, czym jest bramka płatnicza.

Sprzedaż w kilku walutach

Przy sprzedaży w kilku walutach wtyczka pozwala przypisać każdej walucie osobną konfigurację punktu płatności, a numer punktu dla danej waluty dostajesz w panelu PayU. Wtyczka obsługuje to na dwa sposoby: przez wtyczkę WPML, gdzie każda waluta dostaje własną konfigurację punktu, albo przez filtry w kodzie, które włączają wielowalutowość i listę walut. Drugi sposób wymaga drobnej zmiany w kodzie motywu potomnego lub własnej wtyczce.

PayU czy Przelewy24

Obaj operatorzy obsługują BLIK, przelewy i karty, a różnice leżą w szczegółach: dostępnych ratach i płatnościach odroczonych, warunkach umowy i panelu. Konfigurację drugiego operatora opisuję w tekście o Przelewy24 w WooCommerce. Przy wyborze porównaj warunki na prognozie swojej sprzedaży, a nie na przykładach z ofert.

Źródła: PayU GPO Payment for WooCommerce w katalogu WordPress.org i dokumentacja wtyczki PayU na GitHubie.

›Jak podłączyć PayU do WooCommerce?

Zainstaluj wtyczkę PayU GPO Payment for WooCommerce z katalogu WordPress.org, utwórz w panelu PayU punkt płatności typu REST API i wpisz jego POS ID, drugi klucz MD5 oraz client_id i client_secret.

›Dlaczego PayU nie działa mimo poprawnych kluczy?

Najczęściej punkt płatności nie jest typu REST API, klucze produkcyjne są wpisane w pola sandbox albo odwrotnie, albo serwer blokuje powiadomienia z PayU.

›Czy wtyczka PayU obsługuje BLIK i raty?

Tak. Obsługuje BLIK, listę banków, karty, Google Pay, Apple Pay, raty PayU oraz płatności odroczone Klarna, PayPo i Twisto.

›Czy klient może ponowić nieudaną płatność PayU?

Tak, jeśli po nieudanej płatności zamówienie dostaje status „Nieudane”, a nie „Anulowane”. Taką konfigurację ustawiam przy wdrożeniu płatności.

Chcesz przegadać swój projekt?

Odpowiadam osobiście w ciągu 24h w dni robocze — bez handlowca po drodze.