Przelewy24 w WooCommerce: wdrożenie i testy

Autor: Eryk Kamiński · Senior Web Developer · Opublikowano: 3 września 2026 · Aktualizacja: 14 września 2026

Szybka odpowiedź

Przelewy24 w WooCommerce można uznać za wdrożone dopiero po przejściu testów w sandboxie i kontrolowanej płatności produkcyjnej. Sprawdź osobno sukces, przerwanie, odrzucenie, opóźnione potwierdzenie i zwrot. Dla każdej próby porównaj kwotę, walutę, identyfikator transakcji, status zamówienia, notatkę oraz wiadomość do klienta. Koszt obejmuje prowizje operatora, wdrożenie, testy i późniejsze aktualizacje. Sama strona powrotu po płatności nie jest dowodem zapłaty. Sklep powinien zmienić status dopiero po potwierdzeniu transakcji przez operatora.

Schemat bezpiecznego przepływu płatności między koszykiem WooCommerce, weryfikacją i bankiem — Unikalna ilustracja redakcyjna IT-Make przygotowana do tego poradnika.

Potrzebujesz pomocy przy wdrożeniu? Zobacz: Tworzenie sklepów internetowych — zakres usługi.

Macierz odbioru płatności: pięć prób i jeden warunek publikacji

Test płatności powinien mieć zapisany numer zamówienia, czas rozpoczęcia, środowisko, wynik po stronie Przelewy24 i wynik po stronie WooCommerce. Zrzut ekranu „dziękujemy” nie wystarcza. Odbiór kończy się wtedy, gdy panel operatora, notatki zamówienia, status, wiadomości oraz kwota pokazują spójny przebieg.

Każdy scenariusz wykonaj na osobnym zamówieniu. Nie poprawiaj statusu ręcznie przed zapisaniem wyniku, ponieważ ukryjesz zachowanie integracji. Jeśli scenariusz nie jest dostępny w sandboxie, opisz ograniczenie i przeprowadź bezpieczną próbę produkcyjną na minimalnej kwocie uzgodnionej z firmą.

Warunek publikacji powinien być binarny. Wszystkie scenariusze krytyczne mają wynik zgodny z oczekiwaniem albo wdrożenie pozostaje na środowisku testowym. Lista „prawie gotowe” nie chroni obsługi przed wysłaniem towaru dla zamówienia bez potwierdzonej płatności.

Scenariusz	Oczekiwany stan w WooCommerce	Dowód odbioru	Reakcja przy błędzie
Płatność poprawna	Zamówienie otrzymuje status opłaconego zgodny z typem produktu	Ta sama kwota i waluta, identyfikator transakcji, notatka oraz wiadomość	Wstrzymaj automatyczną realizację i porównaj log z panelem operatora
Płatność przerwana przez klienta	Zamówienie nie jest oznaczone jako opłacone	Czytelna możliwość powrotu lub ponowienia bez drugiego zakupu	Sprawdź sesję, wygasanie zamówienia i komunikat w checkout
Płatność odrzucona	Status nie uruchamia realizacji ani faktury jak dla zapłaty	Kod lub opis błędu jest dostępny dla obsługi bez ujawniania danych wrażliwych	Zweryfikuj metodę, konfigurację i notatki; nie zatwierdzaj ręcznie bez dowodu
Opóźnione powiadomienie	Zamówienie czeka na potwierdzenie i zmienia status po komunikacie serwerowym	Zgodność czasu powiadomienia, weryfikacji i zmiany statusu	Sprawdź dostępność adresu powiadomień, zaporę, cache oraz logi
Zwrot pełny	Zamówienie i operacja zwrotu pozostają powiązane	Kwota zwrotu w panelu operatora zgadza się z zamówieniem i notatką	Nie ponawiaj zwrotu, dopóki nie ustalisz stanu pierwszego żądania
Zwrot częściowy	Historia zachowuje kwotę zapłaty i oddaną część	Suma zwrotów nie przekracza zapłaty, a obsługa widzi pozostałą wartość	Porównaj pozycje, podatek, dostawę i identyfikator operacji

Zacznij od konta operatora i gotowości sklepu

Przed instalacją ustal, kto jest właścicielem konta Przelewy24 i kto może zaakceptować warunki operatora. Konto powinno należeć do firmy sprzedającej, nie do wykonawcy sklepu. Firma zachowuje dostęp do panelu, adresu e-mail, numeru telefonu i procedury odzyskania konta.

Sklep musi mieć gotowe informacje potrzebne podczas weryfikacji działalności i procesu zakupu. Sprawdź dane firmy, ofertę, ceny, regulamin, politykę prywatności, zasady dostawy, zwrotów oraz kontakt. Integracja techniczna nie naprawi braków w tych materiałach. Może jedynie ujawnić je na końcu projektu.

Przygotuj środowisko testowe WooCommerce, aktualną kopię oraz plan wycofania zmiany. Sandbox Przelewy24 korzysta z osobnej konfiguracji i danych testowych. Produkcyjne klucze nie powinny trafić do kopii dostępnej publicznie, repozytorium, zgłoszenia ani zrzutu ekranu.

Dobierz właściwy moduł do wersji WooCommerce

Pobieraj moduł z oficjalnej strony Przelewy24 dla WooCommerce. Przed instalacją porównaj obsługiwaną wersję WooCommerce, wymagania PHP, datę wydania i listę zmian. Nie zakładaj, że paczka przechowywana od poprzedniego projektu nadal jest właściwa.

Na dzień publikacji operator udostępnia nowy moduł dla WooCommerce 9.x–11.x. Jego changelog zawiera poprawki dotyczące WooCommerce 11, HPOS, checkoutu blokowego, kart, BLIK, wielu walut i obsługi zwrotów. Zakres ten pokazuje, dlaczego aktualizacja bramki wymaga regresji całej ścieżki zakupu.

Najpierw zainstaluj moduł na kopii. Zapisz wersje WordPressa, WooCommerce, motywu, checkoutu i rozszerzeń modyfikujących zamówienia. Wykonaj próbę przy włączonym cache oraz bez niego. Jeżeli płatność działa tylko po wyłączeniu ważnego dodatku, integracja nie jest gotowa do publikacji.

Skonfiguruj dostęp bez kopiowania sekretów do dokumentacji

Przelewy24 używa danych identyfikujących sprzedawcę oraz kluczy do komunikacji API. Nazwy pól zależą od wersji modułu. Wpisuj je wyłącznie w ustawieniach przeznaczonych dla danego środowiska. Dokument odbioru powinien potwierdzać konfigurację, ale nie może zawierać wartości kluczy, haseł ani pełnych odpowiedzi API.

Oficjalna instrukcja modułu Przelewy24 wymaga dodania adresu IP serwera w panelu operatora przed konfiguracją nowego modułu. Sprawdź publiczny adres wychodzący hostingu. Zmiana infrastruktury lub pośrednika może wymagać ponownej kontroli.

Oddziel dane sandboxa od produkcji także w kopiach i automatycznych wdrożeniach. Po skopiowaniu sklepu produkcyjnego na staging usuń możliwość wysyłania prawdziwych wiadomości oraz inicjowania płatności live. Przed publikacją wykonaj odwrotną kontrolę: tryb testowy nie może pozostać aktywny w produkcji.

Traktuj powiadomienie serwerowe jako źródło statusu płatności

Klient może wrócić do sklepu szybciej niż serwer otrzyma potwierdzenie. Może też zamknąć kartę po zapłacie i nie wrócić wcale. Dlatego adres powrotu służy komunikacji z klientem, a nie samodzielnemu potwierdzaniu płatności. Status musi wynikać z wiarygodnego komunikatu operatora i jego weryfikacji.

Dokumentacja REST API Przelewy24 opisuje rejestrację transakcji, powiadomienie wysyłane na wskazany adres statusu oraz późniejszą weryfikację. Przy ręcznej integracji trzeba zachować kwotę w najmniejszej jednostce, walutę, identyfikator sesji i podpis. Oficjalny moduł realizuje ten proces, lecz nadal trzeba sprawdzić wynik.

Mapowanie statusów zatwierdź przed uruchomieniem. W WooCommerce zamówienie oczekujące na płatność różni się od zamówienia przetwarzanego po zapłacie. Dokumentacja WooCommerce o błędach płatności zaleca kontrolę notatek, logów i środowiska testowego przy statusach, które nie zmieniają się prawidłowo.

Policz koszty operatora, wdrożenia i utrzymania osobno

Koszt Przelewy24 ma co najmniej trzy warstwy. Pierwsza to opłaty i prowizje operatora. Druga obejmuje konfigurację, testy, poprawki checkoutu oraz odbiór. Trzecia to utrzymanie: aktualizacje, monitoring, diagnostyka i ponowne testy po zmianach WooCommerce albo modułu.

Na 3 września 2026 publiczna tabela opłat i prowizji Przelewy24 wskazuje 0 PLN za rejestrację, integrację i abonament. Opłata aktywacyjna wynosi 59 PLN i podlega zwrotowi po spełnieniu warunku podanego przez operatora. Dla przelewu online, BLIK, kart i popularnych portfeli tabela pokazuje 1,29% plus 30 gr. Przed podpisaniem umowy trzeba sprawdzić aktualne i indywidualne warunki.

Nie wpisuj prowizji do budżetu jako jedynego kosztu płatności. Dodaj czas księgowania, uzgadniania wypłat, obsługi błędów, zwrotów i pytań klientów. Przy porównaniu operatorów użyj tej samej liczby transakcji, średniej wartości koszyka, udziału metod i liczby wypłat. Wtedy różnica nie wynika z pominiętej pracy.

Odbierz integrację na telefonie, komputerze i zapleczu

Każdy scenariusz wykonaj w aktualnej wersji checkoutu używanej przez sklep. Sprawdź telefon i komputer, nowego oraz zalogowanego klienta, zakup z kuponem i bez niego. Kontroluj moment opuszczenia sklepu, powrót, możliwość odświeżenia strony oraz zachowanie przy wolnym połączeniu.

Po stronie obsługi otwórz zamówienie, notatki, wiadomości oraz log modułu. Porównaj transakcję z panelem Przelewy24. Dane muszą pozwalać połączyć oba zapisy bez zgadywania. Log nie powinien przechowywać sekretów ani pełnych danych płatniczych. Diagnostykę włączaj na ograniczony czas i chroń dostęp.

Na końcu wykonaj jedną uzgodnioną płatność live. Potwierdź kwotę, status, e-mail, dokument, rozliczenie i możliwość zwrotu. Usuń produkty testowe oraz sprawdź, czy tryb diagnostyczny został wyłączony. Raport odbioru powinien wskazać wersje, datę, osobę testującą i dowody bez danych klienta.

Dwa środowiska i jedna karta odbioru integracji

Karta odbioru zaczyna się od nagłówka: adres środowiska, wersja WooCommerce, wersja modułu, typ checkoutu, waluta i data. Następnie zawiera jeden wiersz dla każdego scenariusza. Wynik zapisuj jako spełniony, niespełniony albo niemożliwy do wykonania wraz z przyczyną. Samo „OK” nie wyjaśnia, co zostało sprawdzone.

W sandboxie przejdź pełną macierz bez realnych środków. Zapisz identyfikatory testowych zamówień i oczekiwane statusy. Sprawdź też przerwę w komunikacji: czasowo zablokuj powiadomienie tylko na odizolowanym środowisku, przywróć dostęp i obserwuj zachowanie. Celem jest poznanie stanu niepewnego bez ryzyka dla produkcji.

W produkcji ogranicz próbę do małej kwoty i wcześniej uzgodnij sposób jej rozliczenia. Nie używaj danych przypadkowej osoby. Po sukcesie wykonaj zwrot zgodnie z procesem dostępnym w używanej wersji modułu. Porównaj godzinę, kwotę i identyfikator po obu stronach.

Do karty dołącz decyzję publikacyjną. Właściciel sklepu akceptuje metody i koszty. Osoba techniczna akceptuje konfigurację, statusy i logi. Obsługa potwierdza wiadomości, realizację oraz zwroty. Brak podpisu właściciela konkretnego obszaru oznacza otwarte zadanie, nie milczącą zgodę.

Mapa statusów, która chroni przed wysyłką bez zapłaty

Dla każdego statusu WooCommerce zapisz znaczenie biznesowe. Określ, czy rezerwuje stan, wysyła e-mail, tworzy dokument, przekazuje zamówienie do magazynu i pozwala na realizację. Integracja płatności może zmienić jeden status, a kolejne automatyzacje uruchamiają się już poza modułem.

Przetestuj także ponowione powiadomienie. Ten sam komunikat nie powinien tworzyć kolejnej płatności, faktury ani wysyłki. Jeśli sklep łączy się z ERP lub BaseLinkerem, porównaj identyfikatory oraz kolejność zdarzeń w obu systemach.

Zwrot jest osobnym procesem finansowym i operacyjnym

Przycisk zwrotu w WooCommerce nie gwarantuje, że środki zostały wysłane przez operatora. Znaczenie zależy od modułu, konfiguracji i uprawnień. Obsługa powinna wiedzieć, czy zwrot jest automatyczny, czy tylko zapisuje korektę w sklepie. W razie wątpliwości trzeba porównać operację z panelem Przelewy24.

Dla zwrotu częściowego ustal, jak traktowana jest dostawa, rabat oraz podatek. Zapisz łączną kwotę wcześniejszych zwrotów. Ponowienie po błędzie wymaga sprawdzenia stanu pierwszego żądania, aby nie oddać środków dwa razy.

Aktualizacja modułu wymaga krótkiej regresji płatności

Przed aktualizacją przeczytaj changelog i wykonaj kopię. Na stagingu sprawdź checkout, metody wyświetlane dla właściwej waluty, sukces, błąd, powrót oraz zwrot. Po publikacji przeprowadź kontrolowaną transakcję i obserwuj pierwsze prawdziwe zamówienia bez ingerowania w ich status.

Włącz alert dla nietypowego wzrostu zamówień oczekujących lub nieudanych. Ustal osobę reagującą i instrukcję porównania WooCommerce z panelem operatora. Monitoring bez progu oraz właściciela jedynie zapisuje problem, zamiast skracać jego czas.

Checklista przed wdrożeniem

firmowe konto Przelewy24 i procedura odzyskania dostępu
kompletne dane firmy, regulamin, polityki oraz kontakt
kopia sklepu i odizolowane środowisko testowe
moduł pobrany z oficjalnego źródła i zgodny z wersją WooCommerce
oddzielne dane sandboxa i produkcji
adres IP serwera dodany w panelu operatora
zatwierdzona mapa statusów oraz automatyzacji
macierz płatności poprawnej, przerwanej, odrzuconej i opóźnionej
zwrot pełny oraz częściowy porównany po obu stronach
kontrolowana płatność live i raport odbioru bez sekretów

Po przejściu listy porównaj wymagania z zakresem na stronie Tworzenie sklepów internetowych — zakres usługi. Jeśli projekt obejmuje wyjątki lub integracje, opisz je w briefie przed wyceną.

Najczęstsze pytania

Czy sama instalacja wtyczki Przelewy24 wystarczy?

Nie. Moduł trzeba skonfigurować dla właściwego środowiska, sprawdzić komunikację, statusy, wiadomości, logi oraz zwroty. Na końcu potrzebna jest kontrolowana transakcja produkcyjna.

Dlaczego opłacone zamówienie pozostaje oczekujące?

Najpierw porównaj transakcję w panelu operatora z notatkami i logami WooCommerce. Częste obszary diagnozy to powiadomienie serwerowe, dane dostępowe, adres IP, cache, zapora oraz konflikt rozszerzeń.

Ile kosztuje Przelewy24 w WooCommerce?

Koszt składa się z warunków operatora oraz pracy wdrożeniowej i utrzymaniowej. Aktualne prowizje sprawdzaj w tabeli Przelewy24 i własnej umowie. Osobno wyceń konfigurację, testy, poprawki, monitoring i regresję po aktualizacjach.

Czy można testować Przelewy24 bez prawdziwych pieniędzy?

Tak, operator udostępnia środowisko sandbox. Nie zastępuje ono jednak końcowej, małej płatności live, która potwierdza produkcyjne dane, komunikację oraz zachowanie prawdziwego sklepu.

Powiązane materiały

Źródło uzupełniające: Przelewy24: oficjalna dokumentacja modułu WooCommerce. Materiał ma charakter projektowy; kwestie prawne, podatkowe i indywidualne obowiązki firmy wymagają odrębnej weryfikacji.