| Ustawienia globalne | Ustawienia metody | |
|---|---|---|
| Domyślnie | Każda metoda korzysta z globalnych kluczy punktu | Opcja „Use global settings” włączona |
| Kiedy zmieniać | Jeden punkt płatności dla całego sklepu | Osobny punkt dla jednej metody, np. rat |
| Co jeszcze ustawiasz | Klucze produkcyjne i testowe | Nazwa, opis, tryb sandbox, ograniczenie do metod dostawy, zamówienia wirtualne |
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
- 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
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
Konto sandbox
Załóż osobne konto testowe PayU i wpisz jego cztery klucze w polach z prefiksem Sandbox. Produkcja i test mają osobne dane.
- 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
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.