Przelewy24 w WooCommerce - konfiguracja krok po kroku

Na oficjalnej stronie pobrania Przelewy24 aktualna gałąź jest opisana dla WooCommerce 9.x-11.x. Dostępne są również odsyłacze do starszych instrukcji. Przed instalacją zanotuj wersję WooCommerce, nazwę i producenta używanej wtyczki oraz sposób zbudowania kasy: klasyczny checkout albo Blocks.

Nie instaluj dwóch różnych modułów P24 w celu sprawdzenia, który zadziała. Najpierw ustal, czy zmieniasz istniejącą integrację, czy dodajesz nową. Zachowaj kopię konfiguracji i możliwość powrotu do wcześniejszej wersji. Przy działającym sklepie testy rozpocznij na odizolowanej kopii, z uwzględnieniem zamówień powstających w produkcji.

Pakiet pobieraj przez stronę operatora. Instrukcja dla nowego modułu prowadzi po instalacji do WooCommerce > Ustawienia > Przelewy24. Jeżeli ekran wygląda inaczej, sprawdź produkt i jego dokumentację, zamiast dopasowywać nazwy pól na pamięć. Obsługa API przez operatora nie jest automatycznym potwierdzeniem zgodności dowolnej wtyczki z Blocks. Szczegóły tej gałęzi znajdziesz w instrukcji modułów P24.

Dane połączenia to identyfikator sprzedawcy, klucz CRC oraz klucz API. P24 wskazuje CRC i klucz API w panelu konta oraz wymaga uzupełnienia IP sklepu. Potwierdza to instrukcja znalezienia danych integracji. Nie publikuj tych wartości w zgłoszeniu ani na zrzucie ekranu.

Potrzebny jest adres serwera, z którego sklep łączy się z API. To nie adres komputera osoby konfigurującej panel. Jeżeli hosting używa osobnego adresu wychodzącego lub puli adresów, uzyskaj właściwe dane od administratora. W nowej dokumentacji ustawienie znajduje się w Moje konto > Konfiguracja API.

Ta kontrola jest czymś innym niż przychodzące powiadomienie o wpłacie. Dodanie IP serwera w panelu operatora nie rozwiąże blokady callbacku przez zaporę sklepu. Dlatego zapisz, na którym etapie pojawia się błąd: połączenie z API, rozpoczęcie płatności czy późniejsza aktualizacja zamówienia.

Konto i rozliczenia powinny pozostawać pod kontrolą właściciela firmy. Aktywację metod oraz wymagania dokumentów potwierdzaj u P24; sama instalacja wtyczki nie zastępuje weryfikacji konta.

W nowym module dane testowe pochodzą ze środowiska Sandbox, a tryb testowy trzeba ustawić w konfiguracji. Nie mieszaj CRC i klucza API pochodzących z różnych kont lub środowisk. Instrukcja P24 opisuje również przycisk Testuj połączenie, który pomaga skontrolować wprowadzone dane.

Pozytywny wynik takiej kontroli nie sprawdza jeszcze obsługi każdej metody, powiadomienia ani zwrotu. Następny etap to pełne zamówienie testowe w dozwolonym scenariuszu sandbox. Nie zakładaj, że środowisko zaakceptuje dowolną wartość testową; stosuj instrukcję przypisaną do wybranej metody.

Przed testami upewnij się, że kopia sklepu nie używa prawdziwych płatności, nie wysyła zleceń do magazynu i nie uruchamia korespondencji do klientów. Sprawdź także automatyczne odnowienia oraz integracje, które mogły zostać skopiowane razem z bazą.

Gdy nie możesz ustalić środowiska, zatrzymaj próbę. Ponowne wklejenie wszystkich kluczy na produkcji utrudnia diagnozę i może przerwać działającą metodę. Zapisz komunikat błędu bez sekretów i sprawdź właściwe konto przed kolejną zmianą.

Najpierw uruchom potrzebny zakres, a następnie sprawdź go w faktycznie używanej kasie. W nowym module P24 wyróżnienie metody może prowadzić do jej operatora, natomiast opcje płacenia wewnątrz sklepu mają odrębną konfigurację. Nie utożsamiaj osobnego kafelka BLIK z formularzem wpisywania kodu w sklepie.

BLIK i zapisany alias opisano szerzej w instrukcji konfiguracji BLIK w WooCommerce. Przy kartach i portfelach sprawdź, czy konto ma uruchomioną właściwą usługę. Widoczny przełącznik we wtyczce nie dowodzi aktywacji po stronie operatora.

Przy obcej walucie nie zakładaj, że samo przełączenie ceny produktu wystarczy. Potwierdź obsługę waluty w integracji i rozliczeniach. Nie wymuszaj wyświetlania metody, której warunki nie obejmują danego koszyka.

Przygotuj tabelę wyników zamiast jednego zrzutu ekranu z komunikatem sukcesu. Dla każdego scenariusza zapisz numer zamówienia, identyfikator testowy operatora, wynik w sklepie i wynik w panelu P24. Nie zapisuj danych uwierzytelniających.

Nie wysyłaj samodzielnie spreparowanych webhooków na produkcyjny adres. Jeśli diagnoza wymaga analizy komunikacji, użyj logów i dokumentacji konkretnej integracji. Płatność za 1 zł w działającym sklepie nie zastępuje scenariuszy negatywnych.

Przy rozbieżności kwoty, waluty lub identyfikatora wstrzymaj odbiór. Nie naprawiaj wyniku ręczną zmianą statusu. Takie zamówienie wymaga wyjaśnienia przyczyny, a nie tylko poprawnego wyglądu w panelu.

Powiadomienie P24 jest niezależne od powrotu użytkownika. Dokumentacja API wymaga dodatkowej weryfikacji transakcji i zaznacza: "Transakcja zostaje uznana za potwierdzoną dopiero po jej weryfikacji." Standardowy moduł powinien obsłużyć tę komunikację; administrator nie ma ręcznie wywoływać API dla każdego zakupu. Źródło: dokumentacja transakcji P24.

W API kwota jest wyrażona w groszach: 1,23 PLN to 123. Przy diagnozie porównuje się więc właściwe jednostki, walutę i powiązane identyfikatory. Sam kod HTTP 200 informuje o odpowiedzi serwera, a nie o poprawnym dopasowaniu wszystkich danych.

W WooCommerce opłacone zamówienie może nadal czekać na realizację. Automatyczne zakończenie dotyczy określonych produktów, m.in. sytuacji, gdy wszystkie są jednocześnie wirtualne i do pobrania. Wyjaśnia to dokumentacja statusów WooCommerce.

Zmiana statusu na zwrócony nie wysyła pieniędzy. Potrzebna jest obsługiwana akcja refundacji przez bramkę albo osobno wykonany zwrot ręczny. Sprawdź wynik operatora i notatkę zamówienia zgodnie z instrukcją zwrotów WooCommerce.

Przed uruchomieniem produkcji potwierdź właściwe dane konta, aktywne metody, adres sklepu i rezultat testów. Ustal osobę odpowiedzialną za rozliczenia oraz sposób zgłaszania rozbieżności. Jeżeli wymagany jest kontrolowany test produkcyjny, jego zakres i rozliczenie uzgodnij z właścicielem sklepu; nie traktuj go jako przypadkowego zakupu klienta.

Zachowaj wersję modułu i listę przyjętych scenariuszy. Po aktualizacji kasa może wymagać ponownego sprawdzenia. Przywracając kopię, uwzględnij zamówienia, które powstały później, aby nie utracić informacji o płatnościach.

Jeżeli płatność nadal zawodzi, przejdź do diagnostyki bramek płatności. Konfigurację drugiego operatora opisuje poradnik PayU. Nie przenoś jego nazw pól do P24.

Integracja płatności od 1499 zł netto obejmuje standardowy zakres jednego PayU, P24 albo Tpay w istniejącym WooCommerce. Naprawy i niestandardowe wdrożenia ustalamy osobno. Przy problemie z WordPressem napisz do nas: wystarczy adres lub platforma i opis celu albo objawu.

• Przelewy24 na stronie firmowej: jak przyjmować płatności
• Płatność Przelewy24 w formularzu na stronie: jak ją wdrożyć
• Przelewy24 i PayPo w sklepie: dostępność, konfiguracja i koszty
• go.przelewy24.pl - co to za strona i jak bezpiecznie sprawdzić płatność