Przelewy24 WooCommerce: wtyczka, konfiguracja i testy płatności
Żeby uruchomić Przelewy24 w WooCommerce, potrzebujesz konta sprzedawcy, zgodnej wtyczki oraz poprawnych danych API. Następnie trzeba sprawdzić cały zakup: wybór płatności, jej potwierdzenie, status zamówienia i zwrot. Samo pojawienie się logo P24 w koszyku nie oznacza jeszcze, że sklep jest gotowy do przyjmowania pieniędzy.
Aktualizacja:
W tym artykule
Ten poradnik prowadzi przez oficjalny moduł Przelewy24. Pokazuje także, kiedy rozważyć inną wtyczkę lub własną integrację. Instrukcje i zakres funkcji sprawdziliśmy 8 października 2026 r. Przed wdrożeniem porównaj je z dokumentacją wersji, którą instalujesz w swoim sklepie internetowym.
Jaką wtyczkę Przelewy24 do WooCommerce wybrać?
Najpierw wybierz rozwiązanie, które odpowiada sposobowi sprzedaży. Oficjalny moduł, wtyczka WP Desk i własne połączenie przez REST API korzystają z tego samego operatora, ale mogą mieć inne ustawienia, obsługę subskrypcji i sposób prezentowania metod klientowi.
| Rozwiązanie | Kiedy je rozważyć | Co sprawdzić |
|---|---|---|
| Oficjalny moduł Przelewy24 | Chcesz korzystać z integracji rozwijanej przez operatora i jego instrukcji konfiguracji. | Wersję WooCommerce, aktywne usługi na koncie, formularz zamówienia i wymagania wybranych płatności. |
| Przelewy24 od WP Desk | Korzystasz z rozwiązań tego producenta lub jego wsparcia technicznego. | Aktualną dokumentację, warunki licencji oraz różnice wobec oficjalnego modułu. |
| Własna integracja REST API | Masz niestandardową ścieżkę zakupu, aplikację lub wymagania, których gotowy moduł nie spełnia. | Rejestrację i weryfikację transakcji, powiadomienia, zwroty oraz koszt utrzymania kodu. |
Jeżeli dopiero wybierasz operatora, zacznij od porównania bramek płatności WooCommerce i prowizji. Tutaj skupiamy się na wdrożeniu P24. Opłat za transakcje nie należy utożsamiać z ceną wtyczki, jej wsparcia czy pracy nad konfiguracją.
Przygotuj konto, WordPress i serwer
Przed instalacją zapisz wersje WordPressa, WooCommerce, PHP, motywu i dodatków ingerujących w zamówienie. Ustal, czy sklep używa klasycznego formularza, czy bloków. Wykonaj kopię zapasową i przygotuj środowisko testowe, aby zmiany nie zakłóciły zakupów klientów.
Na stronie Przelewy24 aktualny moduł jest opisany jako przeznaczony dla WooCommerce 9.x, 10.x i 11.x. To deklarowany zakres wersji, a nie gwarancja zgodności z każdym motywem i dodatkiem. Pakiet oraz historię zmian pobieraj z oficjalnej strony modułu.
Przygotuj też konto sprzedawcy i sprawdź jego aktywację. Potrzebny będzie identyfikator sprzedawcy, klucz CRC i klucz API. Nie umieszczaj kluczy w publicznych zgłoszeniach, zrzutach ekranu ani kodzie strony dostępnym dla klientów.
Adres IP serwera i dostęp do API
Aktualna instrukcja oficjalnego modułu wymaga konfiguracji adresu IP w panelu Przelewy24. Wybierz Moje konto → Konfiguracja API i uzupełnij adresy, z których serwer wykonuje połączenia do operatora. Hosting powinien potwierdzić właściwy statyczny IPv4 lub zakres adresów. Adres domeny widoczny w przeglądarce nie musi być adresem wychodzących połączeń API.
Po zmianie hostingu ponownie sprawdź konfigurację adresu IP serwera. Korzystaj z instrukcji konfiguracji IP Przelewy24. Porady ze starszych artykułów lub dla innych platform mogą dotyczyć innego modułu.
Instalacja i konfiguracja Przelewy24 w WooCommerce
Poniższe kroki dotyczą oficjalnego modułu dla WooCommerce 9.x, 10.x i 11.x. Jeśli wybierzesz WP Desk, użyj instrukcji tego producenta. Nie mieszaj ścieżek ustawień i nazw pól z dwóch różnych wtyczek.
- Pobierz właściwy pakiet ze strony Przelewy24 i sprawdź wymagania swojej wersji.
- W panelu WordPress przejdź do Wtyczki → Dodaj wtyczkę → Wyślij wtyczkę na serwer. Wgraj pobrany plik, zainstaluj i aktywuj moduł.
- Otwórz WooCommerce → Ustawienia → Przelewy24. Wprowadź identyfikator sprzedawcy, klucz CRC i klucz API dla wybranego środowiska.
- Użyj przycisku Testuj połączenie. Jeśli test zgłasza błąd, sprawdź dane i dostęp serwera do API przed dalszą konfiguracją.
- Zapisz zmiany i ustaw sposób wyświetlania płatności. W zakładce Płatności online możesz wybrać wyróżnianie metod obok bramki lub po jej wybraniu.
- Przejdź cały zakup testowy. Sprawdź widok klienta i wynik w panelu zamówień, a nie tylko komunikat testu połączenia.
Źródłem tych kroków jest oficjalna instrukcja instalacji i konfiguracji modułu. Jeśli Twój panel wygląda inaczej, ustal nazwę producenta i wersję wtyczki. Nie kopiuj ustawień na podstawie podobnego logo.
Sandbox, tryb testowy i przejście na produkcję
Tryb testowy pozwala sprawdzić proces bez pobierania prawdziwych pieniędzy. W oficjalnym module użyj konta Sandbox i jego danych dostępowych. W panelu Przelewy24 znajdziesz je przez Moje konto → Konto SANDBOX; istniejące konto testowe ma własną zakładkę Moje dane.
Oddziel dane testowe od produkcyjnych. Po zakończeniu testów wyłącz tryb testowy, ustaw właściwe konto i klucze produkcyjne, zapisz konfigurację oraz ponownie sprawdź połączenie. Upewnij się, że klient nie trafia do testowego środowiska podczas normalnego zakupu.
Po uzgodnieniu z właścicielem sklepu wykonaj niewielką rzeczywistą płatność i sprawdź jej wynik oraz zwrot. To osobny test produkcyjny. Poprawny wynik w środowisku testowym nie potwierdza sam w sobie aktywacji wszystkich usług na koncie produkcyjnym.
Metody płatności: BLIK, karty i portfele
Przygotuj listę metod płatności, które faktycznie chcesz udostępnić. Sprawdź osobno szybkie przelewy, BLIK, kartę oraz portfele, które są aktywne na koncie. Szybkie płatności mają ułatwiać zakup, dlatego opis metody i komunikaty powinny jasno pokazywać klientowi kolejny krok.
BLIK w sklepie WooCommerce
Oficjalny moduł umożliwia wpisanie kodu BLIK na stronie sklepu. Ustawienie znajdziesz w WooCommerce → Ustawienia → Przelewy24 → BLIK. Dokumentacja opisuje również BLIK One Click z zapamiętaniem aliasu dla zalogowanego klienta. Włączenie opcji w panelu powinno zostać potwierdzone testem na koncie z odpowiednio aktywowaną usługą.
Karty, Apple Pay i Google Pay
Oficjalna instrukcja opisuje płatności kartą, Apple Pay i Google Pay wewnątrz sklepu. Wymagają one dodatkowej umowy z operatorem kartowym i włączenia odpowiednich usług. Samo zaznaczenie opcji nie uruchamia ich na każdym koncie.
Przy odbiorze sprawdź przycisk płatności, otwarcie formularza, autoryzację i powrót do zamówienia na obsługiwanych urządzeniach. Przelew z banku i płatność portfelem mają inną ścieżkę, więc nie traktuj jednego udanego zakupu jako testu wszystkich metod.
Wtyczka WP Desk ma odrębny zakres funkcji. Według jej dokumentacji, zmodyfikowanej 20 lipca 2026 r., Apple Pay i Google Pay są dostępne po przekierowaniu na stronę operatora, a nie bezpośrednio w checkoutcie. Porównuj konkretną wersję integracji przed wyborem.
Checkout, HPOS i aktualizacja wtyczki
Przed uruchomieniem sprawdź płatności na stronie finalizacji zamówienia, której naprawdę używa sklep. Klasyczny checkout i Checkout Blocks wymagają osobnego sprawdzenia zgodności. Szczegóły opisujemy w poradniku o blokowym checkoutcie WooCommerce.
Jeżeli korzystasz z HPOS w WooCommerce, uwzględnij go w testach płatności i zwrotów. Historia zmian oficjalnego modułu zawiera aktualizacje obsługi bloków i HPOS, ale nie zastępuje testu zestawu rozszerzeń Twojego sklepu WooCommerce.
Aktualizacja powinna obejmować kopię zapasową, próbę na środowisku testowym i kontrolę całej ścieżki zakupu. Zapisuj wersję modułu oraz datę wdrożenia. Ułatwi to ustalenie przyczyny, jeśli po zmianie zniknie metoda lub przestanie aktualizować się status.
Potwierdzenie płatności i status zamówienia
Powrót klienta na stronę podziękowania nie jest samodzielnym dowodem zapłaty. Dokumentacja REST API rozdziela adres powrotu urlReturn od adresu powiadomień urlStatus. Potwierdzenie jest wysyłane asynchronicznie, a system sprzedawcy weryfikuje wynik transakcji.
Przy gotowej wtyczce sprawdź, czy komunikacja działa i płatność zostaje przypisana do właściwego zamówienia. Przy własnej integracji trzeba wdrożyć ten mechanizm zgodnie z oficjalnym opisem przepływu transakcji. Nie oznaczaj zamówienia jako opłaconego tylko dlatego, że otworzył się adres powrotu.
Testuj także sytuację, w której klient zamknie kartę przeglądarki po zapłacie. Porównaj identyfikator, kwotę i walutę w obu panelach. Statusy zamówień powinny odpowiadać faktycznemu wynikowi i rodzajowi sprzedaży. E-mail o nowym zamówieniu również nie zastępuje potwierdzenia płatności.
Przelewy24 nie działa: co sprawdzić?
Zacznij od ustalenia etapu błędu. Zapisz czas zdarzenia, wersję integracji, metodę i numer zamówienia. Przygotowując zgłoszenie do wsparcia, usuń klucze API i dane płatnicze klienta z logów oraz zrzutów.
| Objaw | Pierwsza kontrola | Co potwierdzić |
|---|---|---|
| Nie widać bramki | Włączenie metody, waluta i zgodność formularza zamówienia. | Widoczność dla gościa i zalogowanego klienta. |
| Test połączenia zgłasza błąd | Dane konta, klucze, środowisko i adres IP. | Dostęp serwera do API oraz aktywację konta. |
| BLIK albo portfel jest niedostępny | Aktywne usługi i wymagania wybranej wtyczki. | Konfigurację metody oraz obsługiwane urządzenie. |
| Klient zapłacił, zamówienie oczekuje | Wynik u operatora i odbiór powiadomienia przez sklep. | Weryfikację transakcji, kwotę, walutę i notatki zamówienia. |
| Problem pojawił się po aktualizacji | Historię zmian modułu, motywu i dodatków. | Odtworzenie problemu na środowisku testowym. |
To kolejność diagnostyki, a nie lista pewnych przyczyn każdego błędu. Jeżeli płatność ma niejasny wynik, sprawdź oba systemy przed ręczną zmianą statusu lub prośbą o ponowną zapłatę.
Zwroty i płatności cykliczne
Oficjalny moduł pozwala zlecać zwroty z zamówienia w WooCommerce. Instrukcja wskazuje przycisk Zwrot, wprowadzenie kwoty i Zwróć przez Przelewy24. Kwota nie może przekroczyć wartości zamówienia ani wolnych środków na koncie. Sprawdź potwierdzenie zwrotu i jego wynik u operatora. Więcej o procedurze przeczytasz w artykule o zwrotach płatności w WooCommerce.
Płatności cykliczne zaplanuj oddzielnie. Oficjalna instrukcja opisuje własny produkt Subskrypcja P24, konto klienta, aktywne płatności kartą, wymagane usługi i działający WP-Cron. WP Desk opisuje współpracę z Flexible Subscriptions lub WooCommerce Subscriptions. Nie zakładaj, że modele subskrypcji różnych wtyczek są wymienne.
Checklista odbioru wdrożenia
- Sprawdzono wersję wtyczki, ustawienia konta, IP i połączenie API.
- Gość oraz zalogowany klient mogą przejść koszyk i wybrać właściwą metodę.
- Przetestowano udaną, przerwaną i odrzuconą płatność oraz ponowną próbę.
- Sprawdzono potwierdzenia i status bez powrotu klienta do sklepu.
- Zweryfikowano kwoty z dostawą, rabatem i używanymi walutami.
- Sprawdzono telefon, klawiaturę i komunikaty błędów.
- Wyłączono środowisko testowe przed sprzedażą i sprawdzono konfigurację produkcyjną.
- Właściciel zna procedurę zwrotu, dostęp do wsparcia i plan aktualizacji.
Chcesz przygotować płatności razem z całym sklepem? W Sitefy dobieramy rozwiązanie do projektu i pomagamy zaplanować wdrożenie. Zobacz naszą usługę tworzenia sklepów internetowych i opisz obecny sklep, używane rozszerzenia oraz potrzebne metody płatności.
Najczęściej zadawane pytania
Czy oficjalna wtyczka Przelewy24 jest jedyną opcją?
Nie. Możesz wybrać moduł operatora, rozwiązanie innego producenta lub własną integrację API. Porównaj funkcje, zgodność i sposób utrzymania. Każda opcja wymaga własnych testów.
Jak skonfigurować Przelewy24 w WooCommerce?
Wybierz zgodny moduł, skonfiguruj konto i IP serwera, wpisz dane API, sprawdź połączenie oraz pełny zakup. Dla oficjalnego modułu użyj zakładki WooCommerce → Ustawienia → Przelewy24.
Czy jeden udany test oznacza, że można sprzedawać?
Sprawdź każdą udostępnioną metodę, potwierdzenie zamówienia i przypadki błędów. Test połączenia potwierdza tylko część procesu. Przed sprzedażą trzeba zweryfikować również konto i ustawienia produkcyjne.
Dlaczego zapłacone zamówienie nadal oczekuje?
Sprawdź wynik transakcji w panelu Przelewy24 oraz odbiór i weryfikację powiadomienia w sklepie. Sam powrót kupującego nie potwierdza płatności. Nie zmieniaj statusu bez ustalenia wyniku.
Czy Apple Pay działa bezpośrednio w checkoutcie?
Zależy od integracji. Oficjalny moduł opisuje płatności wewnątrz sklepu z dodatkowymi wymaganiami. Dokumentacja WP Desk z 20 lipca 2026 r. opisuje Apple Pay po przekierowaniu. Sprawdź aktualne wymagania swojego rozwiązania.
Chcesz uporządkować sklep WooCommerce?
Opisz katalog, checkout, płatności, dostawę i obecne integracje. Ustalimy zakres wdrożenia oraz testów dopasowany do Twojego procesu.
