PayU — jak działa: konto i zwroty

WooCommerce PayU łączy sklep WooCommerce z bramką płatniczą PayU. Klient opłaca zamówienie online, a sklep otrzymuje informację o wyniku transakcji. W artykule opisujemy przebieg płatności, integrację przez wtyczkę lub API, zwroty i typowe błędy. Wyjaśniamy też, czym różni się podłączenie PayU do PrestaShop i Shopify. PayU przewiduje cztery statusy zamówienia: PENDING, WAITING_FOR_CONFIRMATION, COMPLETED i CANCELED¹.

Czym jest konfiguracja WooCommerce PayU i jak uruchomić płatności?

Konfiguracja WooCommerce PayU zaczyna się od instalacji wtyczki płatniczej. Następnie trzeba połączyć ją z kontem sprzedawcy i włączyć metodę płatności w sklepie. Do połączenia służą dane z panelu PayU, a przed uruchomieniem płatności warto sprawdzić zamówienie oraz jego status. Wtyczka wymaga WooCommerce w wersji co najmniej 6.0².

PayU GPO Payment for WooCommerce ma ponad 10 000 aktywnych instalacji³. Wtyczka obsługuje Secure Form, czyli formularz płatniczy. Działa on również w kasie opartej na WooCommerce Blocks^3,4.

Jak zainstalować wtyczkę PayU w WooCommerce?

Wtyczkę PayU GPO Payment for WooCommerce zainstalujesz z panelu WordPressa. Najpierw sprawdź środowisko sklepu: potrzebny jest WordPress 5.0 lub nowszy oraz PHP 7.4 lub nowszy. Wtyczkę przetestowano do wersji WordPress 7.1.2³.

• Wtyczkę PayU GPO Payment for WooCommerce znajdź przez wyszukiwarkę w panelu WordPressa.
• Instalację wtyczki uruchom po wybraniu właściwej pozycji, a potem aktywuj ją w WordPressie.
• Ustawienia płatności otwórz w WooCommerce, by przygotować połączenie z kontem PayU.

Aktywacja wtyczki udostępnia ustawienia integracji, lecz nie wystarcza do przyjmowania płatności. Trzeba jeszcze skonfigurować konto sprzedawcy. Dla jednego punktu płatności POS wpisuje się cztery dane: identyfikator POS, drugi klucz MD5, OAuth client_id i OAuth client_secret⁵.

Jak połączyć WooCommerce z kontem PayU za pomocą danych API?

WooCommerce połączysz z PayU przez dane punktu płatności POS, skonfigurowanego w panelu sprzedawcy do przyjmowania transakcji. Wtyczka działa wyłącznie z POS typu REST API – interfejsem wymiany danych między sklepem a PayU³. Token OAuth używany do komunikacji z REST API PayU jest ważny przez 43 199 sekund⁶.

• Panel sprzedawcy PayU otwórz, a następnie wybierz punkt płatności POS typu REST API.
• Dane dostępowe POS przepisz z panelu PayU do odpowiednich pól w ustawieniach wtyczki WooCommerce.
• Ustawienia integracji zapisz po przypisaniu danych do właściwego sklepu.

Po zapisaniu danych właściwego POS możesz sprawdzić połączenie WooCommerce z PayU. Wtyczka pozwala skonfigurować dwa środowiska: produkcyjne i testowe Sandbox. Każde korzysta z osobnego zestawu czterech danych POS⁵.

Jak przetestować i włączyć płatności PayU w sklepie?

PayU w WooCommerce sprawdzisz, składając zamówienie tak, jak zrobiłby to klient. Następnie porównaj wynik transakcji z zamówieniem zapisanym w sklepie. Jedna z kart udostępnionych przez PayU do testów w Sandbox ma 16-cyfrowy numer 4444333322221111⁷.

• Metodę płatności PayU włącz w ustawieniach WooCommerce po zapisaniu konfiguracji wtyczki.
• Zamówienie testowe złóż w kasie sklepu, wybierając PayU jako sposób zapłaty.
• Wynik płatności porównaj w panelu sprzedawcy PayU i przy tym samym zamówieniu w WooCommerce.

Płatności PayU są gotowe do użycia, gdy klient widzi tę metodę w kasie, a sklep zapisuje wynik transakcji przy zamówieniu. Samo wyświetlenie metody nie wystarcza; trzeba jeszcze sprawdzić przekazanie statusu. Sklep powinien potwierdzić odbiór powiadomienia odpowiedzią HTTP 200¹.

Jak sprawdzić, czy WooCommerce odbiera statusy płatności z PayU?

WooCommerce odbiera status prawidłowo, jeśli stan właściwego zamówienia odpowiada wynikowi transakcji w PayU. Status płatności wskazuje etap lub wynik transakcji. Przy porównywaniu danych uwzględnij cztery statusy zamówienia PayU: PENDING, WAITING_FOR_CONFIRMATION, COMPLETED i CANCELED¹.

• Transakcję PayU znajdź w panelu sprzedawcy i ustal jej wynik.
• Zamówienie WooCommerce otwórz dla tej samej płatności i porównaj jego stan z wynikiem w PayU.
• Rozbieżność statusów sprawdź w ustawieniach integracji oraz komunikacji sklepu z PayU, zanim ręcznie zmienisz stan zamówienia.

Porównuj dane PayU i WooCommerce dotyczące tej samej transakcji. Powrót klienta do sklepu sam w sobie nie potwierdza zapłaty. Odbiór powiadomienia PayU sklep potwierdza kodem HTTP 200, niezależnie od tego powrotu¹.

Czym jest integracja PayU z WooCommerce i jak obsługuje zamówienia?

Integracja PayU z WooCommerce wiąże wybór metody w kasie z transakcją i zamówieniem. W standardowym przebiegu klient trafia na stronę PayU. Tam wybiera typ płatności dostępny na przypisanym mu POS³. Przy standardowym utworzeniu zamówienia odpowiedź PayU z kodem HTTP 302 zawiera adres redirectUri do przekierowania klienta⁸.

PayU GPO Payment for WooCommerce udostępnia listę banków, kartę, BLIK, raty, Klarnę, PayPo, Twisto, Twisto Pay in 3 i PragmaPay. PragmaPay jest przeznaczony wyłącznie dla klientów biznesowych³. To, które metody pojawią się przy danym zamówieniu, zależy od ich aktywacji na POS sprzedawcy³. Kod BLIK wpisywany podczas płatności ma sześć cyfr⁹.

Jak przebiega płatność za zamówienie przez PayU?

PayU obsługuje transakcję, gdy klient wybierze tę metodę przy zamówieniu w WooCommerce. Klient przechodzi do dostępnego sposobu zapłaty i kończy płatność, a sklep przypisuje wynik do zamówienia. Spośród czterech statusów PayU tylko COMPLETED oznacza przyjęcie płatności¹.

• Zamówienie WooCommerce powstaje po zatwierdzeniu koszyka i wybraniu PayU w kasie.
• Metoda płatności pozwala klientowi wybrać sposób zapłaty dostępny dla jego transakcji.
• Status zamówienia odczytaj w WooCommerce po zakończeniu płatności; sam powrót klienta do sklepu nie potwierdza zapłaty.

Wynik transakcji PayU wyznacza dalszą obsługę zamówienia. Operator przekazuje cztery możliwe statusy zamówienia: PENDING, WAITING_FOR_CONFIRMATION, COMPLETED oraz CANCELED¹.

Dlaczego płatność może się nie powieść lub jej status nie wraca do sklepu?

Płatność PayU w WooCommerce może pozostać niedokończona, jeśli klient jej nie sfinalizuje. Innym problemem jest rozbieżność statusów: sklep i operator pokazują wtedy różne wyniki tej samej transakcji. Zacznij od porównania zamówienia w WooCommerce z transakcją w panelu PayU. Jeśli wynik w PayU jest poprawny, sprawdź konfigurację integracji i odbiór informacji przez sklep¹⁰.

Wtyczka PayU GPO Payment for WooCommerce pobiera listę metod płatności z użyciem 60-sekundowej pamięci podręcznej³. Lista może więc odświeżyć się z opóźnieniem. Nie oznacza to samo w sobie nieudanej płatności.

Czym różni się oficjalna wtyczka PayU od integracji innego dostawcy?

PayU GPO Payment for WooCommerce oraz wtyczka PayU firmy Platiti to odrębne integracje. Ich zgodność i warunki użytkowania trzeba więc oceniać osobno. Produkt Platiti dynamicznie wyświetla metody podczas składania zamówienia i automatycznie zmienia jego status według wyniku płatności¹¹. Obsługuje waluty CZK, EUR, PLN, HUF, GBP, USD i RON; jest też zgodny z Checkout Blocks, WPML, Elementorem, HPOS i Gutenbergiem¹¹.

Wtyczka Platiti obejmuje 12 miesięcy wsparcia technicznego i dostępu do aktualizacji¹¹. Warianty zakupu różnią się zakresem usługi. Tabela zestawia ten zakres z przybliżoną ceną¹¹.

Dane w tabeli: 11

Wybór wtyczki zależy od potrzebnej zgodności technicznej i zakresu wdrożenia. W obu wariantach obsługa zamówienia wymaga powiązania transakcji z jej statusem.

Bezpieczeństwo płatności online: na co zwrócić uwagę?

Obsługa PayU w WooCommerce wymaga zabezpieczeń zarówno w usłudze płatniczej, jak i w sklepie. Dotyczy to danych dostępowych, połączenia z kasą oraz informacji o wyniku transakcji. Administrator powinien ograniczyć dostęp do obu paneli do upoważnionych osób. Jeden POS korzysta z czterech danych: identyfikatora POS, drugiego klucza MD5, OAuth client_id i OAuth client_secret⁵.

Status zamówienia powinien wynikać z informacji przekazanej przez usługę płatniczą. Sam powrót klienta do sklepu nie wystarcza. Dane uwierzytelniające integrację trzeba przechowywać poza publiczną treścią strony. Odbiór powiadomienia PayU sklep potwierdza odpowiedzią HTTP 200¹.

Jakie zabezpieczenia obejmuje usługa płatnicza?

Usługa płatnicza PayU jest częścią ochrony transakcji, lecz nie zastępuje zabezpieczeń sklepu ani konta sprzedawcy. Przy ocenie integracji sprawdź przekazywanie danych płatniczych, uprawnienia do panelu i potwierdzanie wyniku zapłaty. Zakres zabezpieczeń zależy również od wybranej metody płatności i konfiguracji sklepu¹². Sklep potwierdza odbiór powiadomienia o statusie odpowiedzią HTTP 200¹.

Bezpieczna obsługa zamówienia wymaga zgodności jego statusu w sklepie z wynikiem transakcji u operatora. To wynik transakcji stanowi punkt odniesienia.

WooCommerce jako platforma do obsługi płatności w sklepie

WooCommerce służy do prowadzenia zamówień, a wtyczka bramki łączy je z transakcjami u operatora. Sprzedawca obsługuje stan zamówienia w sklepie, ale wynik zapłaty ustala na podstawie transakcji w PayU. Spośród czterech statusów PayU przyjęcie płatności oznacza COMPLETED¹.

Nieopłacone zamówienie wymaga ustalenia, czy klient przerwał płatność, czy transakcję odrzucono. Przed ponowieniem płatności klient powinien sprawdzić stan zamówienia. Pozwoli mu to uniknąć ponownej zapłaty za opłacony już zakup. Sprzedawca może zestawić identyfikator zamówienia z transakcją widoczną w panelu operatora.

Zwrot pieniędzy to coś innego niż zmiana statusu zamówienia. Oznaczenie zakupu jako zwróconego w sklepie nie potwierdza jeszcze odesłania środków klientowi. Sprzedawca powinien powiązać zwrot z właściwą transakcją i sprawdzić jego wynik u operatora. WooCommerce porządkuje obsługę zamówień, lecz płatność lub zwrot potwierdza wynik odpowiedniej operacji.

Ceny i warunki sprawdzone u źródeł: październik 2026.