Jak naprawić błąd wtyczki Przelewy24 w WooCommerce i zmienić status zamówienia

Wprowadzenie: gdy płatność Przelewy24 nie zmienia statusu zamówienia

Klient kończy płatność przez Przelewy24, środki pojawiają się na Twoim koncie, a w panelu WooCommerce zamówienie nadal ma status „Oczekujące na płatność” lub nawet „Anulowane”. Brzmi znajomo? Taki błąd wtyczki Przelewy24 w WooCommerce, w którym płatność nie zmienia statusu zamówienia, to częsty problem w wielu sklepach internetowych.

Taka sytuacja jest frustrująca zarówno dla Ciebie, jak i dla klientów. Utrudnia obsługę zamówień, generuje dodatkową korespondencję i może podważać zaufanie do sklepu. Na szczęście w większości przypadków przyczyna leży w kilku powtarzalnych błędach konfiguracji lub komunikacji.

W tym artykule zobaczysz, dlaczego płatność Przelewy24 nie aktualizuje statusu zamówienia w WooCommerce oraz poznasz konkretne kroki, jak to zdiagnozować i naprawić. Przejdziemy przez mechanizm działania powiadomień, najczęstsze przyczyny problemów, a także praktyczne wskazówki, jak uniknąć ich w przyszłości.

Zrozumienie całego procesu pozwoli Ci spojrzeć na Twój sklep jak na dobrze działającą maszynę. Gdy wiesz, gdzie może pojawić się błąd, dużo łatwiej jest szybko go usunąć i zadbać o płynny przepływ zamówień w Twoim e-commerce.

Jak działa Przelewy24 w WooCommerce? Mechanizm zmiany statusu zamówienia

Zanim zaczniesz naprawiać błąd, warto dokładnie zrozumieć, co dzieje się między Przelewy24 a WooCommerce w momencie opłacania zamówienia. To właśnie ten mechanizm najczęściej ulega przerwaniu, przez co status zamówienia nie aktualizuje się automatycznie.

Standardowo proces płatności wygląda tak:

1. Klient wybiera metodę płatności Przelewy24 w Twoim sklepie.
2. System przekierowuje go na stronę płatności Przelewy24.
3. Klient opłaca zamówienie.
4. Po pomyślnej transakcji Przelewy24 wysyła informację zwrotną (IPN/webhook) do Twojego sklepu.
5. WooCommerce odbiera komunikat i zmienia status zamówienia na „W trakcie realizacji” lub inny zdefiniowany status.

Jeśli ostatni etap nie zadziała, zamówienie pozostaje w niezmienionym statusie, mimo że środki zostały zaksięgowane. Oznacza to, że komunikacja zwrotna została zablokowana, źle skonfigurowana lub odrzucona po drodze.

Czym jest IPN (Instant Payment Notification) w Przelewy24?

IPN, czyli Instant Payment Notification, to kluczowy element prawidłowej zmiany statusu zamówienia w WooCommerce. To automatyczne powiadomienie wysyłane z serwerów Przelewy24 na specjalny URL powiadomień w Twoim sklepie.

Ten adres URL pełni rolę „furtki” do WooCommerce:

• Przelewy24 wysyła na niego dane o zakończonej płatności.
• WooCommerce przetwarza te dane i aktualizuje status zamówienia.
• Jeśli adres jest zły, zablokowany, nieaktywny lub zwraca błąd – informacja nie dociera, a status zamówienia się nie zmienia.

Można to porównać do listonosza, który zna adres, ale zastaje zamknięte drzwi lub błędny numer domu. List zostaje nadany, ale nigdy nie trafia do odbiorcy, choć nadawca swoje zadanie wykonał poprawnie.

Najczęstsze przyczyny: dlaczego płatność Przelewy24 nie zmienia statusu zamówienia?

Skoro wiesz już, że sedno problemu leży w komunikacji między Przelewy24 a WooCommerce, przejdźmy do najczęstszych powodów, przez które płatność nie zmienia statusu zamówienia. W większości przypadków winny jest jeden z kilku powtarzających się błędów.

1. Błędna konfiguracja URL powiadomień (IPN) w panelu Przelewy24

Najczęstsza przyczyna to nieprawidłowy adres URL powiadomień ustawiony w panelu Przelewy24. Jeśli system nie wie, dokąd wysłać informacje o płatnościach, nie zrobi tego w ogóle lub wyśle je pod zły adres.

Co sprawdzić krok po kroku:

• Zaloguj się do panelu Przelewy24.
• Przejdź do sekcji typu „Moje dane” lub „Dane firmy”.
• Odszukaj pole odpowiedzialne za „Adres URL powiadomień” lub podobnie brzmiące ustawienie.
• Zweryfikuj, czy adres jest poprawny. Najczęściej wygląda on tak:
• https://twojastrona.pl/wc-api/WC_Gateway_P24/ lub
• https://twojastrona.pl/?wc-api=WC_Gateway_P24
• Upewnij się, że:
• adres jest w HTTPS, jeśli sklep działa na HTTPS,
• nie ma literówek ani zbędnych spacji,
• używany jest właściwy format, zgodny z dokumentacją Twojej wtyczki Przelewy24.

Niewielki błąd w tym miejscu całkowicie uniemożliwia poprawną zmianę statusu zamówień.

2. Blokady po stronie serwera: firewall, limity, konfiguracja hostingu

Twój serwer chroni sklep przed niepożądanym ruchem, ale czasem taka ochrona jest zbyt agresywna. Firewall lub inne zabezpieczenia mogą blokować IPN z Przelewy24, traktując je jak podejrzany ruch.

Warto zwrócić uwagę na:

• Blokady firewall – hosting może mieć ustawione reguły blokujące połączenia z niektórych adresów IP lub typów zapytań HTTP.
• Białe listy IP – poproś hostingodawcę o dodanie adresów IP serwerów Przelewy24 do whitelisty. Listę tych adresów możesz uzyskać bezpośrednio od Przelewy24.
• Limity zasobów – zbyt niskie limity pamięci, czasu wykonania skryptów lub przeciążony serwer mogą sprawić, że skrypt odpowiedzialny za obsługę IPN nie zakończy się poprawnie.

Jeśli serwer odpowiada błędem (np. 500) lub w ogóle nie odpowiada na żądanie Przelewy24, status zamówienia w WooCommerce nie zostanie zaktualizowany.

3. Konflikty z innymi wtyczkami i motywem WordPress

Wtyczki i motyw w Twoim WordPressie mogą ze sobą kolidować. Konflikt z inną wtyczką bywa subtelny, ale potrafi całkowicie zablokować działanie IPN.

Najczęściej problemem są:

• inne wtyczki płatnicze,
• wtyczki bezpieczeństwa,
• dodatki do optymalizacji bazy danych lub cache,
• niestandardowe motywy modyfikujące proces zamówień.

Konflikt może polegać na:

• nadpisaniu fragmentów kodu odpowiedzialnych za obsługę IPN,
• generowaniu błędów PHP w trakcie obsługi powiadomienia,
• modyfikowaniu adresów URL lub parametrów żądań.

W efekcie Przelewy24 wysyła powiadomienie, ale WooCommerce nie jest w stanie poprawnie go obsłużyć.

4. Nieprawidłowe klucze API, ID sprzedawcy lub klucz CRC

Przelewy24 komunikuje się z Twoim sklepem przy użyciu kluczy uwierzytelniających. Jeśli którykolwiek z nich jest błędny, system uzna żądanie za nieautoryzowane, a transakcja nie zostanie poprawnie powiązana z zamówieniem.

Najważniejsze elementy do weryfikacji:

• ID sprzedawcy,
• klucz CRC,
• dodatkowe klucze API, jeśli są używane w danej integracji.

Sprawdź w ustawieniach wtyczki Przelewy24 w WooCommerce (np. w WooCommerce > Ustawienia > Płatności > Przelewy24), czy:

• wszystkie wartości są identyczne z tymi w panelu Przelewy24,
• nie ma literówek, dopisanych spacji na początku lub końcu,
• nie pomyliłeś danych środowiska testowego z produkcyjnym.

Nawet drobny błąd w jednym znaku może spowodować, że status zamówienia nie będzie się zmieniał mimo poprawnie zaksięgowanej płatności.

5. Błędy widoczne w logach Przelewy24, WooCommerce i serwera

Logi to najlepsze źródło informacji, gdy błąd wtyczki Przelewy24 nie jest oczywisty. Zarówno Przelewy24, jak i WooCommerce zapisują szczegóły komunikacji, w tym nieudane próby powiadomień.

Warto przejrzeć:

• Logi Przelewy24 – w panelu operatora płatności znajdziesz historię powiadomień IPN oraz status ich dostarczenia (np. błędy 404, 500, brak odpowiedzi).
• Logi WooCommerce – w WordPressie wejdź w WooCommerce > Status > Logi i wybierz logi związane z Przelewy24, np. przelewy24-YYYY-MM-DD.log.
• Logi serwera – plik error_log lub odpowiednia sekcja w panelu hostingu może wskazać konkretne błędy PHP lub problemy z dostępem.

Z logów często dowiesz się:

• czy powiadomienie w ogóle dotarło do sklepu,
• jaki kod odpowiedzi zwrócił serwer,
• jaki dokładnie błąd wystąpił po stronie WooCommerce.

6. Przestarzała wersja PHP lub za małe zasoby serwera

Nieaktualne środowisko serwerowe jest częstą, choć mniej widoczną przyczyną problemów. Stare wersje PHP mogą być niekompatybilne z nowszymi wersjami WooCommerce czy wtyczki Przelewy24.

W panelu WooCommerce > Status sprawdź:

• wersję PHP – zalecana to co najmniej 7.4, a najlepiej 8.x,
• WP Memory Limit – powinien wynosić minimum 256MB, a optymalnie 512MB.

Jeśli środowisko jest przestarzałe lub zbyt „ciasne”, skrypty odpowiedzialne za obsługę płatności mogą się przerywać, zanim status zamówienia zostanie zmieniony.

Jak krok po kroku naprawić błąd wtyczki Przelewy24 w WooCommerce?

Gdy znasz już główne źródła problemu, czas przejść do działań. Poniżej znajdziesz konkretną procedurę diagnostyczną, która pozwoli Ci znaleźć i usunąć błąd powodujący, że płatność Przelewy24 nie zmienia statusu zamówienia.

Pamiętaj: przed wprowadzeniem większych zmian wykonaj aktualną kopię zapasową sklepu.

Krok 1: Sprawdzenie konfiguracji w panelu Przelewy24

1. Zaloguj się do swojego konta w Przelewy24.
2. Przejdź do ustawień integracji lub danych sklepu.
3. Zweryfikuj Adres URL powiadomień (IPN):
4. sprawdź zgodność z wymaganym formatem,
5. upewnij się, że używasz właściwego protokołu (HTTPS),
6. usuń ewentualne spacje i literówki.
7. Sprawdź ID sprzedawcy, klucz CRC i klucze API:
8. porównaj je z tym, co masz wpisane w ustawieniach wtyczki Przelewy24 w WooCommerce,
9. upewnij się, że wszystkie dane pochodzą z tego samego środowiska (testowe/produkcyjne).

Ta weryfikacja rozwiązuje znaczną część problemów bez konieczności dalszej ingerencji.

Krok 2: Analiza logów Przelewy24, WooCommerce i serwera

1. W panelu Przelewy24 otwórz sekcję z logami lub historią powiadomień.
2. sprawdź, czy system wysyłał powiadomienie IPN do Twojego sklepu,
3. zwróć uwagę na kody błędów (np. 404, 500) i komunikaty.
4. W WordPressie wejdź w WooCommerce > Status > Logi.
5. wybierz logi związane z Przelewy24 (np. przelewy24-YYYY-MM-DD.log),
6. poszukaj wpisów z błędami, które występują w momencie próby aktualizacji płatności.
7. Jeśli masz dostęp do logów serwera (np. error_log lub sekcja błędów w panelu hostingu), przejrzyj je pod kątem:
8. błędów PHP,
9. błędów połączeń,
10. ograniczeń zasobów.

Na podstawie logów możesz dokładnie określić, czy problem leży po stronie Przelewy24, WooCommerce, czy samego serwera.

Krok 3: Kontakt z hostingodawcą i weryfikacja serwera

Jeśli logi wskazują na błędy połączenia, odrzucanie żądań lub problemy z zasobami:

1. Skontaktuj się z obsługą swojego hostingu.
2. Opisz problem: status zamówienia w WooCommerce nie zmienia się po płatności Przelewy24.
3. Poproś o:
4. sprawdzenie, czy firewall lub inne zabezpieczenia nie blokują połączeń z IP Przelewy24,
5. dodanie adresów IP Przelewy24 do białej listy (whitelisty),
6. weryfikację limitów pamięci, czasu wykonania skryptów i obciążenia serwera,
7. analizę logów serwera pod kątem błędów związanych z obsługą Twojego sklepu.

Dobry hosting jest w stanie szybko wskazać, czy problem leży w konfiguracji serwera lub jego ograniczeniach.

Krok 4: Test konfliktów wtyczek i motywu

Jeśli konfiguracja i serwer wyglądają poprawnie, kolejnym krokiem jest wykluczenie konfliktów:

1. Zainstaluj wtyczkę Health Check & Troubleshooting z repozytorium WordPressa.
2. Uruchom tryb rozwiązywania problemów (tylko dla administratora).
3. Wyłącz wszystkie wtyczki poza:
4. WooCommerce,
5. wtyczką Przelewy24.
6. Ustaw domyślny motyw (np. Storefront lub Twenty Twenty-Four).
7. Złóż testowe zamówienie i opłać je przez Przelewy24.
8. Jeśli status zamówienia zmienia się poprawnie – masz konflikt z inną wtyczką lub motywem.
9. Włączaj kolejne wtyczki pojedynczo, za każdym razem robiąc testową płatność, aż znajdziesz tę, która powoduje problem.
10. Jeśli błąd pojawia się po włączeniu Twojego motywu, to on może odpowiadać za blokadę lub błąd.

Taka metoda „eliminacji” jest najbardziej skuteczna przy skomplikowanych konfiguracjach sklepów.

Krok 5: Aktualizacje WooCommerce, wtyczki Przelewy24 i PHP

Kolejny ważny krok to upewnienie się, że pracujesz na aktualnych wersjach oprogramowania:

1. Sprawdź, czy:
2. WordPress jest zaktualizowany,
3. WooCommerce ma najnowszą wersję,
4. wtyczka Przelewy24 jest aktualna.
5. W WooCommerce > Status zerknij na:
6. wersję PHP (zaktualizuj do co najmniej 7.4, najlepiej 8.x),
7. WP Memory Limit (minimum 256MB, optymalnie 512MB).
8. W razie potrzeby poproś hostingodawcę o aktualizację PHP lub zwiększenie limitów.

Nowsze wersje często zawierają poprawki błędów właśnie w obszarze integracji z bramkami płatności.

Krok 6: Wykonuj testowe płatności po każdej zmianie

Po każdej z powyższych modyfikacji:

1. Złóż testowe zamówienie w sklepie.
2. Opłać je przez Przelewy24.
3. Obserwuj:
4. czy status zamówienia zmienia się automatycznie,
5. czy w logach pojawiają się nowe błędy.

To jedyny pewny sposób, by stwierdzić, że błąd wtyczki Przelewy24 w WooCommerce został faktycznie rozwiązany, a płatność prawidłowo zmienia status zamówienia.

Jak uniknąć problemów z Przelewy24 w przyszłości? Dobre praktyki dla sklepu WooCommerce

Gdy już uporasz się z aktualnym błędem, warto zadbać o to, aby podobne problemy nie wracały w przyszłości. Kilka prostych zasad pozwoli Ci znacznie ograniczyć ryzyko problemów z płatnościami.

Najważniejsze dobre praktyki:

• Regularne aktualizacje
  Dbaj o aktualność:
• WordPressa,
• WooCommerce,

• wtyczki Przelewy24
  Nowsze wersje eliminują stare błędy i poprawiają bezpieczeństwo.

• Monitorowanie logów
  Co jakiś czas zaglądaj do:

• logów WooCommerce,

• logów Przelewy24.
  Wczesne wychwycenie nietypowych wpisów pozwala zareagować, zanim klienci odczują skutki problemu.

• Testy po każdej większej zmianie
  Po:

• instalacji nowej wtyczki,
• aktualizacji motywu,

• zmianach na serwerze
  wykonaj testowe zamówienie z płatnością Przelewy24. To Twoja szybka kontrola jakości.

• Stabilny, sprawdzony hosting
  Wybierz usługodawcę, który:

• zapewnia stabilne środowisko PHP,
• oferuje pomoc w kwestiach firewall, whitelist, limitów,

• szybko reaguje na zgłoszenia dotyczące integracji z bramkami płatniczymi.

• Regularne kopie zapasowe
  Kopie zapasowe sklepu to Twoja „cyfrowa polisa ubezpieczeniowa”. Dzięki nim szybko cofniesz się do poprzedniego stanu, jeśli po aktualizacji lub zmianie konfiguracji coś pójdzie nie tak.

• Korzystanie z oficjalnych i sprawdzonych wtyczek
  Instaluj wtyczki z oficjalnego repozytorium lub od renomowanych deweloperów. Unikaj „pirackich” wersji, które często są źle napisane, podatne na błędy lub zawierają złośliwy kod.

Dzięki tym zasadom Twój sklep będzie działał stabilniej, a płatności Przelewy24 będą prawidłowo zmieniały status zamówień w WooCommerce. Klienci zyskają pewność, że ich zamówienia są szybko obsługiwane, a Ty ograniczysz stres związany z ręcznym sprawdzaniem i aktualizowaniem płatności.