Przelewy24 w WooCommerce — konfiguracja krok po kroku

Sklep bez działającej bramki płatniczej nie jest sklepem, tylko katalogiem. Poniżej cała procedura podpięcia Przelewy24 do WooCommerce: od założenia konta, przez klucze API i tryb testowy, po pięć błędów, które najczęściej powodują, że zamówienie zostaje opłacone, ale w panelu nadal wisi jako „oczekujące”. Jeśli natomiast dopiero wybierasz operatora, zacznij od naszego porównania bramek płatności w WooCommerce.

Co daje Przelewy24 w polskim sklepie

Przelewy24 (operator: PayPro S.A. z Poznania) to agregator płatności — jedna integracja daje klientowi dostęp do kilkuset metod: szybkich przelewów ze wszystkich większych polskich banków, BLIK-a, kart płatniczych, Google Pay i Apple Pay oraz płatności odroczonych. Dla sklepu oznacza to jedną umowę i jedno rozliczenie zamiast negocjacji z każdym bankiem osobno.

BLIK to dziś najważniejszy powód, dla którego polskie sklepy w ogóle wdrażają agregator. W zamówieniach mobilnych bywa najczęściej wybieraną metodą, a jego brak w koszyku bezpośrednio przekłada się na porzucenia — o czym piszemy szerzej przy okazji porzuceń koszyka w WooCommerce.

Zanim zaczniesz — czego potrzebujesz

• Zarejestrowana działalność (JDG lub spółka) — bramki nie podpiszą umowy z osobą prywatną.
• Sklep online z regulaminem i polityką prywatności — operator weryfikuje serwis przed aktywacją.
• Konto firmowe do wypłat.
• Certyfikat SSL na domenie sklepu — bez tego integracja nie przejdzie weryfikacji.
• Aktualne WooCommerce i PHP (co najmniej wersja wspierana przez wtyczkę — sprawdź w opisie w repozytorium).

Weryfikacja konta trwa zwykle od jednego do kilku dni roboczych. Zaplanuj ją z wyprzedzeniem — to jeden z najczęstszych powodów przesunięcia startu sprzedaży.

Krok 1. Rejestracja i uzyskanie danych integracyjnych

1. Załóż konto w panelu Przelewy24 i przejdź weryfikację firmy (dane z CEIDG/KRS, numer konta, adres sklepu).
2. Po akceptacji w panelu znajdziesz trzy wartości, które będą potrzebne przy konfiguracji: – ID sprzedawcy (merchant ID), – ID sklepu (POS ID) — przy jednym sklepie zwykle identyczne z ID sprzedawcy, – Klucz CRC oraz klucz do REST API.
3. Skopiuj je do menedżera haseł. Nie przesyłaj kluczy mailem ani komunikatorem — to dane dostępowe do Twoich pieniędzy.

Krok 2. Instalacja wtyczki

W panelu WordPressa: Wtyczki → Dodaj nową → wyszukaj oficjalną wtyczkę Przelewy24 dla WooCommerce → Zainstaluj → Włącz.

Zawsze wybieraj wtyczkę oficjalną, wydawaną przez operatora. Nieoficjalne integracje bywają porzucane przez autorów, a płatności to ostatnie miejsce, w którym chcesz mieć nieaktualizowany kod. Po instalacji sprawdź datę ostatniej aktualizacji i deklarowaną kompatybilność z Twoją wersją WooCommerce.

Krok 3. Konfiguracja w WooCommerce

Przejdź do WooCommerce → Ustawienia → Płatności i włącz Przelewy24, następnie Zarządzaj:

W panelu Przelewy24 uzupełnij jeszcze adres URL powiadomień (webhook). To on odpowiada za automatyczną zmianę statusu zamówienia po opłaceniu — bez niego zamówienia zostaną w statusie „oczekujące na płatność” mimo pobranych pieniędzy.

Krok 4. Testy w trybie sandbox

Sandbox to osobne środowisko z osobnym kontem i osobnymi kluczami. Przetestuj cztery ścieżki:

1. Płatność udana → zamówienie przechodzi w Przetwarzane, klient dostaje maila.
2. Płatność anulowana przez klienta → zamówienie zostaje Wstrzymane, koszyk nie znika.
3. Płatność odrzucona → komunikat jest zrozumiały i pozwala spróbować ponownie.
4. Zamknięcie okna przeglądarki w trakcie → status aktualizuje się po otrzymaniu powiadomienia.

Dopiero po przejściu wszystkich czterech wyłącz sandbox i wykonaj jedną prawdziwą transakcję na najniższą możliwą kwotę — z własnej karty lub BLIK-iem. Następnie zwróć ją z panelu, sprawdzając przy okazji, jak działa procedura zwrotu.

Krok 5. Podłączenie faktur i logistyki

Opłacone zamówienie to dopiero początek procesu. Żeby nie wystawiać faktur ręcznie, spinamy WooCommerce z systemem księgowym — opisujemy to w tekście o automatycznych fakturach w WooCommerce. Analogicznie z wysyłką: etykiety kurierskie generowane automatycznie z poziomu zamówienia oszczędzają kilkanaście minut dziennie.

Pięć błędów, które widzimy najczęściej

1. Zamówienia zostają jako „oczekujące na płatność” mimo pobranych pieniędzy. W 90% przypadków to niepoprawny adres powiadomień w panelu operatora albo blokada żądań przychodzących przez firewall lub wtyczkę bezpieczeństwa. Sprawdź logi WooCommerce (WooCommerce → Status → Dzienniki).

2. Błąd sumy kontrolnej CRC. Klucz skopiowany razem ze spacją na końcu albo pomylone środowisko: klucz sandboxowy wpisany w konfigurację produkcyjną.

3. Kwota nie zgadza się o grosze. Klasyczny problem zaokrągleń przy stawkach VAT i rabatach. WooCommerce przekazuje kwotę w groszach — sprawdź ustawienia zaokrąglania w WooCommerce → Ustawienia → Podatki.

4. Płatność działa, ale nie wraca na stronę podziękowania. Zwykle konflikt z wtyczką cache’ującą. Strony koszyka, zamówienia i konta muszą być wyłączone z cache — to reguła, o której zapomina się przy każdej migracji hostingu.

5. BLIK nie pojawia się w koszyku. Metoda musi być włączona po stronie panelu operatora, a nie tylko w WooCommerce. Sprawdź też walutę — BLIK obsługuje wyłącznie PLN.

A co z PayU, Tpay i Stripe?

Procedura jest w każdym przypadku analogiczna: rejestracja → weryfikacja → klucze → wtyczka → sandbox → transakcja testowa. Różnice sprowadzają się do trzech rzeczy: stawki prowizji, terminu wypłat i jakości wsparcia technicznego po polsku. Warto negocjować — prowizje przy większym obrocie są ustalane indywidualnie, a różnica 0,2 punktu procentowego przy obrocie 100 tys. zł miesięcznie to 2 400 zł rocznie.

Stripe warto rozważyć, jeśli sprzedajesz za granicę lub prowadzisz płatności cykliczne — więcej o tym drugim scenariuszu w tekście o subskrypcjach w WooCommerce.

[DO UZUPEŁNIENIA] — miejsce na dane z realizacji: sklep, w którym dodanie BLIK-a/poprawienie webhooka zmieniło udział porzuconych koszyków. Np. z realizacji Metal4Home lub Doretti.

Kiedy oddać to komuś innemu

Podpięcie bramki na standardowym sklepie to praca na godzinę. Wdrożenie robi się poważne, gdy dochodzą: raty i płatności odroczone, waluty obce, subskrypcje, marketplace z podziałem płatności albo zgodność z procedurą chargeback. Jeśli którykolwiek z tych punktów dotyczy Twojego sklepu, zbudujemy i skonfigurujemy sklep WooCommerce razem z integracjami — a przed decyzją możesz sprawdzić opłacalność wdrożenia w kalkulatorze ROI sklepu.

FAQ — Przelewy24 i płatności w WooCommerce

Ile kosztuje Przelewy24? Model jest prowizyjny — operator pobiera procent od transakcji, bez opłat wdrożeniowych przy standardowej integracji. Stawki różnią się w zależności od metody płatności (BLIK, przelew i karta są wyceniane osobno) i są negocjowalne przy większych obrotach. Aktualny cennik zawsze sprawdzaj u operatora — zmienia się częściej niż treść artykułów.

Czy potrzebuję firmy, żeby przyjmować płatności online? Tak. Agregatorzy płatności zawierają umowy wyłącznie z podmiotami prowadzącymi działalność gospodarczą i weryfikują je na podstawie rejestrów.

Kiedy pieniądze trafiają na moje konto? Zależy od umowy — najczęściej w cyklu dziennym lub kilkudniowym. Termin wypłat to jeden z ważniejszych parametrów przy wyborze operatora, zwłaszcza gdy zamawiasz towar od dostawcy dopiero po otrzymaniu płatności.

Czy mogę mieć kilka bramek jednocześnie? Tak i bywa to uzasadnione — np. agregator dla płatności krajowych plus Stripe dla zagranicznych. Pamiętaj tylko, że każda dodatkowa metoda w koszyku wydłuża decyzję. Trzy sensowne opcje konwertują lepiej niż osiem.

Czy WooCommerce Payments to to samo co Przelewy24? Nie. WooCommerce Payments to rozwiązanie samego Woo oparte o Stripe — wygodne, ale w Polsce ustępuje agregatorom krajowym pod względem obsługi BLIK-a i szybkich przelewów bankowych, które odpowiadają za większość transakcji w polskim e-commerce.

Autor: Adrian Kamiński — Websky Studio, Poznań. Wdrażamy sklepy WooCommerce z integracjami Przelewy24, InPost, BaseLinker i Subiekt GT.