Przelewy24 WooCommerce: integracja i konfiguracja krok po kroku
Przelewy24 WooCommerce, konfiguracja krok po kroku: konto i klucze, sandbox, typowe błędy i prowizje w praktyce. Sprawdź, jak podpiąć płatności bez stresu.
Integracja Przelewy24 WooCommerce łączy Twój sklep z bramką płatności: klient płaci BLIK-iem, szybkim przelewem lub kartą, a WooCommerce otrzymuje potwierdzenie transakcji i sam aktualizuje status zamówienia.
Dobrze skonfigurowane płatności skracają obsługę sklepu. Nie musisz ręcznie sprawdzać przelewów ani pojedynczo zmieniać statusów zamówień. Wszystkie transakcje trafiają do panelu Przelewy24, gdzie kontrolujesz wpłaty, rozliczenia oraz zwroty.
Jak działa integracja Przelewy24 WooCommerce
Obraz wygenerowany przez AI
Oficjalna wtyczka łączy WooCommerce z systemem Przelewy24. Klient wybiera metodę płatności, kończy transakcję, a informacja o jej wyniku wraca do sklepu.
W checkoucie, czyli na stronie składania zamówienia, możesz udostępnić między innymi BLIK, szybkie przelewy bankowe, karty, portfele cyfrowe oraz raty. Dokładna lista zależy od metod aktywnych na Twoim koncie Przelewy24, waluty zamówienia i ustawień wtyczki.
Część płatności może odbywać się bezpośrednio w sklepie. Dotyczy to choćby wybranych wariantów BLIK-a i płatności kartą. Przy pozostałych metodach klient przechodzi na formatkę operatora, wybiera bank lub sposób płatności, a później wraca na stronę z podsumowaniem zamówienia.
Po udanej transakcji Przelewy24 wysyła do WooCommerce osobne potwierdzenie. Sklep oznacza zamówienie jako opłacone i przechodzi do dalszej realizacji. Jeśli klient przerwie płatność albo bank ją odrzuci, zamówienie pozostaje nieopłacone.
Ty dostajesz dostęp do historii transakcji, raportów, salda i rozliczeń w panelu Przelewy24. Z tego samego miejsca możesz zlecać zwroty całkowite oraz częściowe. Przy poprawnie skonfigurowanym kluczu API część tych operacji da się wykonać również z poziomu zamówienia w WooCommerce.
Zanim zaczniesz: konto Przelewy24 i dane sklepu
Obraz wygenerowany przez AI
Najpierw załóż konto sprzedawcy w Przelewy24 i przejdź weryfikację firmy. Do konfiguracji sklepu przygotuj ID sprzedawcy, klucz CRC oraz klucz API.
Podczas rejestracji podajesz dane firmy, rachunek do wypłat i adres sklepu. Operator może poprosić o przelew weryfikacyjny oraz dokumenty związane z działalnością. Sprawdzi również sam sklep, dlatego przed zgłoszeniem powinny działać koszyk i checkout. Na stronie powinny być dostępne regulamin, polityka prywatności, dane sprzedawcy, informacje o dostawie i zasady zwrotów. Jeśli dopiero budujesz sklep, przejdź najpierw przez mój przewodnik jak założyć sklep internetowy na WordPressie. Weryfikację łatwiej przejść z kompletną stroną.
ID sprzedawcy otrzymasz po rejestracji. Klucz CRC i klucz API znajdziesz w ustawieniach konta, w sekcji z danymi API i konfiguracją. Klucz API bywa opisany jako klucz do raportów. Znaczenie poszczególnych danych i pełny opis połączenia znajdziesz w dokumentacji technicznej Przelewy24.
Każdy z tych elementów ma inne zadanie: ID wskazuje właściwe konto, klucz CRC pozwala sprawdzić, czy dane transakcji dotarły bez zmian, a klucz API daje wtyczce dostęp do dodatkowych operacji, na przykład pobierania metod płatności lub obsługi zwrotów.
Skopiuj dane bez spacji na początku i końcu. Jeden dodatkowy znak wystarczy, aby test połączenia zakończył się błędem.
Sprawdź też adres sklepu zapisany w panelu Przelewy24. Powinien odpowiadać adresowi używanemu przez klientów, łącznie z protokołem HTTPS i właściwą wersją domeny. Jeśli sklep działa pod adresem z „www”, podaj właśnie ten wariant. Przy dostępie do usług API może być również potrzebny adres IP serwera.
Konfiguracja Przelewy24 w WooCommerce krok po kroku
Konfiguracja obejmuje instalację oficjalnej wtyczki, wpisanie danych konta i uruchomienie wybranych metod. Na koniec trzeba złożyć zamówienie próbne i sprawdzić cały proces od koszyka do zmiany statusu.
Krok 1. Zainstaluj oficjalną wtyczkę Przelewy24
Aktualny moduł Przelewy24 WooCommerce pobierzesz z oficjalnej strony operatora. Wybierz wersję przeznaczoną dla używanej wersji WooCommerce. Plik powinien mieć format ZIP.
W panelu WordPressa przejdź do sekcji „Wtyczki”, wybierz „Dodaj nową”, a następnie „Wyślij wtyczkę na serwer”. Wskaż pobrany plik, uruchom instalację i aktywuj moduł.
Przed instalacją zrób kopię zapasową sklepu. Sprawdź również dostępne aktualizacje WordPressa, WooCommerce i używanego motywu. Wtyczkę płatniczą najlepiej testować na aktualnym, wspieranym środowisku. Stara wersja PHP albo WooCommerce może powodować błędy w checkoucie i obsłudze powiadomień.
Po aktywacji przejdź do „WooCommerce”, następnie do „Ustawień” i zakładki „Płatności”. Na liście powinna pojawić się pozycja Przelewy24.
Krok 2. Wpisz dane z panelu: ID sprzedawcy, klucz CRC i klucz API
Otwórz ustawienia Przelewy24 i włącz tę metodę płatności. W odpowiednich polach wpisz ID sprzedawcy, ID sklepu lub POS ID, klucz CRC oraz klucz API.
W podstawowej konfiguracji ID sprzedawcy i POS ID zwykle mają tę samą wartość. Jeśli na koncie utworzono kilka punktów sprzedaży, użyj danych przypisanych do właściwego sklepu. Zajrzyj do panelu Przelewy24, zamiast zgadywać numer na podstawie innej integracji.
Dane produkcyjne i testowe należą do dwóch oddzielnych środowisk. Jeśli konfigurujesz sandbox, wszystkie wpisane wartości muszą pochodzić z konta testowego. Mieszanka produkcyjnego ID z testowym kluczem CRC zakończy się błędem połączenia.
Po zapisaniu ustawień użyj testu dostępu, jeśli wtyczka udostępnia taką opcję. Poprawny wynik potwierdza połączenie z kontem. Nadal potrzebujesz zamówienia próbnego, bo sam test danych nie sprawdza działania koszyka, powrotu z płatności i zmiany statusu.
Krok 3. Ustaw metody płatności w checkoucie
Włącz metody, z których mają korzystać klienci. Dobry zestaw na początek obejmuje BLIK, szybkie przelewy oraz karty. Przy droższych produktach możesz dodać raty lub płatności odroczone, jeśli są aktywne w Twojej umowie.
Liczba widocznych opcji wpływa na wygląd checkoutu. Kilkanaście osobnych kafelków banków może niepotrzebnie wydłużyć formularz na telefonie. Często lepiej wyróżnić dwie lub trzy popularne metody, a pozostałe pokazać po przejściu na formatkę Przelewy24.
Ustaw czytelną nazwę płatności, na przykład „Przelewy24: BLIK, szybki przelew lub karta”. Klient od razu wie, jakie możliwości znajdzie po jej wybraniu. Sprawdź też kolejność metod. Płatności internetowe powinny znaleźć się wysoko, szczególnie gdy większość zamówień jest opłacana online.
Dostępność poszczególnych opcji może zależeć od waluty. Raty są zwykle prezentowane dla zamówień w złotówkach, a obsługa kart w innych walutach wymaga właściwej konfiguracji konta. Przy sklepie wielowalutowym przetestuj każdą walutę osobno.
Krok 4. Zapisz i sprawdź stronę płatności testowym zamówieniem
Zapisz ustawienia, wyczyść pamięć podręczną sklepu i otwórz stronę w prywatnym oknie przeglądarki. Dodaj produkt do koszyka, przejdź przez checkout i wybierz Przelewy24.
Sprawdź, czy metoda wyświetla się na komputerze i telefonie. Zwróć uwagę na zgodę dotyczącą operatora płatności, komunikaty błędów, przejście do płatności i stronę wyświetlaną po powrocie do sklepu.
Po zakończeniu transakcji otwórz zamówienie w WooCommerce. Status powinien zmienić się z „Oczekujące na płatność” na status używany dla opłaconych zamówień, najczęściej „W trakcie realizacji”. Ich pełną listę opisuje dokumentacja zamówień WooCommerce (EN). Potwierdź także obecność transakcji w panelu Przelewy24 i zgodność kwoty, waluty oraz numeru zamówienia.
Sandbox i przejście na produkcję
Sandbox pozwala przejść cały proces bez pobierania pieniędzy z prawdziwego rachunku. Po udanych testach podmieniasz dane na produkcyjne, wyłączasz tryb testowy i wykonujesz pierwszą rzeczywistą płatność kontrolną.
Konto testowe uruchomisz z poziomu konta Przelewy24. Sandbox ma własne ID, klucz CRC i klucz API. Skopiuj komplet danych do ustawień wtyczki, a następnie włącz tryb testowy.
Wykonaj kilka scenariuszy. Sprawdź udaną płatność, anulowanie jej na formatce i powrót do sklepu bez zakończenia transakcji. Jeśli sprzedajesz w kilku walutach, przeprowadź próbę dla każdej z nich. Przy zwrotach przetestuj także zwrot częściowy i całkowity.
Kiedy wszystko działa, wyłącz sandbox i usuń testowe dane z konfiguracji. Wklej komplet kluczy produkcyjnych, zapisz ustawienia i ponownie sprawdź połączenie.
Pierwsze zamówienie produkcyjne złóż na niewielką kwotę. Zapłać prawdziwą metodą, zaczekaj na aktualizację statusu i porównaj zapis w WooCommerce z transakcją w panelu operatora. Kontrola kilku ekranów zajmie parę minut, a potwierdzi działanie całej ścieżki.
Typowe błędy przy integracji i jak je naprawić
Większość problemów z integracją Przelewy24 WooCommerce powodują pomylone dane dostępowe, pamięć podręczna albo blokada powiadomień z Przelewy24. Zacznij od sprawdzenia środowiska, kluczy, kwoty i waluty transakcji.
Błąd CRC zwykle oznacza literówkę, dodatkową spację lub użycie klucza z innego konta. Częstym przypadkiem jest połączenie danych produkcyjnych z sandboxem. Skopiuj ponownie cały zestaw, upewnij się, że tryb wtyczki odpowiada wybranemu panelowi, i wykonaj test dostępu.
Zdarza się też, że klient płaci poprawnie, ale zamówienie nadal czeka na wpłatę. Przyczyną bywają zablokowane powiadomienia zwrotne. Wyczyść cache, wyłącz na próbę optymalizację dla koszyka, checkoutu i adresów obsługujących płatności. Sprawdź reguły firewalla, zabezpieczenia hostingu oraz dziennik błędów WooCommerce.
Kolejny trop to niezgodna kwota lub waluta. Problem może pojawić się przy wtyczkach rabatowych, przelicznikach walut, zaokrągleniach albo zmianie wartości zamówienia po rozpoczęciu płatności. Porównaj dane zapisane w WooCommerce z informacjami widocznymi przy transakcji w Przelewy24.
Konflikt może powodować również druga wtyczka płatności albo narzędzie modyfikujące checkout. Wyłączaj podejrzane rozszerzenia pojedynczo na kopii testowej sklepu. Po każdej zmianie składaj nowe zamówienie, ponieważ stara sesja płatności może zawierać wcześniejsze dane.
Włącz logi Przelewy24 i WooCommerce na czas diagnozy. Numery zamówienia, komunikaty API oraz godziny powiadomień zwykle pokazują moment, w którym proces został przerwany. Po rozwiązaniu problemu wyłącz rozbudowane logowanie, aby ograniczyć ilość przechowywanych danych.
Prowizje Przelewy24 w praktyce
Przelewy24 rozlicza standardowe płatności przez prowizję od każdej transakcji i nie pobiera miesięcznego abonamentu. Aktualne stawki sprawdzisz w publicznym cenniku operatora, swoim panelu oraz zawartej umowie.
Według standardowego cennika BLIK, szybkie przelewy i karty płatnicze są rozliczane stawką 1,9% albo 1,29% + 30 gr za transakcję, zależnie od wybranego wariantu. Warunki mogą być inne przy ofercie indywidualnej, dodatkowych metodach albo programie promocyjnym. Przed uruchomieniem sklepu oprzyj kalkulację na stawce przypisanej do Twojego konta.
Stałe 30 groszy ma większe znaczenie przy małych koszykach. Dla zamówienia za 20 zł koszt w wariancie 1,29% + 30 gr wynosi około 56 groszy, czyli mniej więcej 2,8% wartości sprzedaży. Przy koszyku za 50 zł będzie to około 95 groszy, a przy 200 zł około 2,88 zł. Jeśli sprzedajesz tanie produkty, uwzględnij tę różnicę w marży albo ustal sensowną minimalną wartość zamówienia.
Rejestracja, integracja i miesięczny abonament mają standardowo stawkę 0 zł. Opłata aktywacyjna wynosi 59 zł i podlega zwrotowi po wykonaniu 10 produkcyjnych transakcji w ciągu pierwszych dwóch miesięcy współpracy.
Samo wykonanie zwrotu jest bezpłatne. Prowizja pobrana za obsługę pierwotnej płatności pozostaje rozliczona, ponieważ transakcja została wykonana. Przy dużej liczbie zwrotów ten koszt również powinien znaleźć się w kalkulacji marży. Prowizje to zresztą tylko część budżetu sklepu. Pełne zestawienie znajdziesz w artykule ile kosztuje sklep internetowy.
Od czego zacząć
Zacznij od konta sprzedawcy i przygotowania sklepu do weryfikacji. Następnie skonfiguruj sandbox, wykonaj próbne transakcje, wprowadź dane produkcyjne i sprawdź jedno prawdziwe zamówienie.
Samodzielna konfiguracja Przelewy24 WooCommerce ma sens, gdy sklep korzysta ze standardowego WooCommerce, jednego języka, jednej waluty i prostego checkoutu. Instalacja oficjalnej wtyczki oraz uzupełnienie danych zajmują wtedy zwykle mniej pracy niż szukanie rozwiązania pisanego specjalnie dla sklepu.
Pomoc techniczna przyda się przy wielu walutach, płatnościach cyklicznych, zmodyfikowanym checkoucie i konfliktach między wtyczkami. Podobnie przy sklepie, który już sprzedaje i każda przerwa w płatnościach oznacza utracone zamówienia. W takim przypadku konfigurację trzeba połączyć z kopią zapasową, testami na osobnym środowisku i kontrolowanym wdrożeniem. Tak wyglądało to na przykład przy sklepie Pokrycianadach.pl, który zbudowałem na WooCommerce. A jeśli wolisz oddać cały temat w jedne ręce: prowadzę sklepy WooCommerce od makiety po pierwsze zamówienie.
Jeśli porównujesz bramki płatności, zobacz też mój przewodnik po integracji PayU z WooCommerce.
FAQ
Ile wynosi prowizja Przelewy24 w WooCommerce?
Według standardowego cennika płatności BLIK, szybkie przelewy i karty są rozliczane stawką 1,9% albo 1,29% + 30 gr za transakcję, bez miesięcznego abonamentu. Opłata aktywacyjna 59 zł jest zwracana po 10 transakcjach w ciągu dwóch pierwszych miesięcy. Stawki indywidualne znajdziesz w swojej umowie i panelu.
Czy integracja Przelewy24 WooCommerce wymaga programisty?
Przy standardowym sklepie zwykle nie. Oficjalna wtyczka i trzy dane z panelu (ID sprzedawcy, klucz CRC, klucz API) wystarczą, żeby uruchomić płatności w jedno popołudnie. Pomoc techniczna przydaje się przy wielu walutach, zmodyfikowanym checkoucie albo konfliktach wtyczek.
Jak przetestować płatności Przelewy24 przed startem sklepu?
Włącz konto testowe sandbox, wpisz jego dane do wtyczki i przejdź pełną ścieżkę: udaną płatność, anulowanie transakcji i powrót do sklepu bez płacenia. Po testach podmień dane na produkcyjne i złóż jedno prawdziwe zamówienie na małą kwotę.
Dlaczego zamówienie w WooCommerce nie zmienia statusu po opłaceniu?
Najczęściej powiadomienie zwrotne z Przelewy24 nie dociera do sklepu. Sprawdź cache i jego wykluczenia dla checkoutu, reguły firewalla, zabezpieczenia hostingu oraz logi WooCommerce. Pomocne bywa też porównanie kwoty i waluty zamówienia z transakcją w panelu operatora.
Czy Przelewy24 obsługuje BLIK w WooCommerce?
Tak. BLIK jest jedną z podstawowych metod dostępnych w integracji, obok szybkich przelewów i kart. Wybrane warianty BLIK-a mogą działać bezpośrednio w sklepie, bez przechodzenia na stronę operatora. Zależy to od ustawień wtyczki i Twojego konta.