PayPal w WooCommerce – jak skonfigurować płatności krok po kroku

Żeby przyjmować płatności PayPal w WooCommerce, potrzebujesz konta PayPal Business i oficjalnej wtyczki WooCommerce PayPal Payments. Po instalacji wchodzisz w WooCommerce → Ustawienia → Płatności, otwierasz ustawienia PayPal i łączysz konto przyciskiem w kreatorze — bez ręcznego kopiowania kluczy API. Na koniec włączasz metodę płatności i robisz zamówienie testowe.

Poniżej znajdziesz pełną instrukcję: od przygotowania konta, przez tryb testowy, po rozwiązania najczęstszych problemów, takich jak niewidoczne przyciski czy zamówienia wiszące w statusie „Oczekujące na płatność”.

Co przygotować przed konfiguracją PayPal w WooCommerce

Zanim zainstalujesz wtyczkę, sprawdź cztery rzeczy:

1. Konto PayPal Business. Konto osobiste nie wystarczy. Możesz przekształcić istniejące konto w firmowe w ustawieniach profilu PayPal albo założyć nowe. Konto powinno być zweryfikowane i mieć podpięty rachunek bankowy do wypłat.
2. Aktualne WordPress i WooCommerce. Wtyczka PayPal Payments wymaga względnie nowych wersji i nowoczesnego PHP. Zrób kopię zapasową przed aktualizacjami.
3. Certyfikat SSL. Sklep musi działać pod https://. Bez tego przeglądarki ostrzegą klientów, a część funkcji płatności nie zadziała.
4. Walutę sklepu. Ustawisz ją w WooCommerce → Ustawienia → Ogólne → Opcje walut. PayPal obsługuje PLN, EUR, USD i wiele innych walut, ale nie wszystkie.

Ważne: Nie używaj metody „PayPal Standard” wbudowanej w starsze wersje WooCommerce. Od wersji 5.5 jest ukryta w nowych instalacjach i nie jest rozwijana. Jeśli Twój sklep nadal z niej korzysta, przejdź na PayPal Payments — wtyczka zaproponuje migrację ustawień.

Krok 1: instalacja wtyczki WooCommerce PayPal Payments

1. W panelu WordPressa przejdź do Wtyczki → Dodaj nową.
2. Wyszukaj „WooCommerce PayPal Payments” (autor: WooCommerce).
3. Kliknij Zainstaluj teraz, a potem Włącz.

Wtyczka jest darmowa. Płacisz wyłącznie prowizje od transakcji naliczane przez PayPal — ich aktualną wysokość dla Polski sprawdzisz w cenniku na stronie PayPal po zalogowaniu na konto firmowe. Prowizje zależą od rodzaju płatności i kraju kupującego, dlatego warto je przeliczyć przed ustaleniem cen.

Krok 2: połączenie sklepu z kontem PayPal

1. Przejdź do WooCommerce → Ustawienia → Płatności i otwórz ustawienia PayPal (w nowszych wersjach WooCommerce lista metod płatności ma odświeżony wygląd, ale PayPal jest na niej wyraźnie oznaczony).
2. Uruchomi się kreator konfiguracji. Wybierz, czy prowadzisz sprzedaż jako firma, i zaznacz, jakie produkty sprzedajesz (fizyczne, wirtualne, subskrypcje).
3. Kliknij przycisk połączenia z PayPal. Otworzy się okno logowania PayPal — zaloguj się na konto Business i zaakceptuj uprawnienia dla WooCommerce.
4. Po powrocie do sklepu zobaczysz status połączonego konta i identyfikator sprzedawcy.

Ręczne wpisywanie Client ID i Secret jest potrzebne tylko w nietypowych sytuacjach (np. gdy okno logowania blokuje przeglądarka). Dane te znajdziesz w panelu PayPal Developer w sekcji aplikacji REST API.

Nazwy przycisków i kolejność ekranów kreatora zmieniają się wraz z wersjami wtyczki, ale logika pozostaje ta sama: logujesz się do PayPal, zatwierdzasz uprawnienia, wracasz do sklepu z aktywnym połączeniem.

Krok 3: wybór metod płatności i wyglądu przycisków

Po połączeniu w ustawieniach wtyczki zdecydujesz, co dokładnie zobaczy klient:

• Przyciski PayPal — klient loguje się na swoje konto PayPal w wyskakującym oknie i potwierdza płatność.
• Płatność kartą przez PayPal — klient może zapłacić kartą bez konta PayPal. Rozszerzony formularz kart osadzony bezpośrednio na stronie (Advanced Card Processing) jest dostępny tylko w części krajów i dla części kont.
• Lokalne metody płatności — PayPal udostępnia w Europie alternatywne metody, m.in. BLIK i Przelewy24. To, które z nich zobaczysz w ustawieniach, zależy od kraju konta i wersji wtyczki.
• Lokalizacja przycisków — możesz pokazać przyciski na stronie produktu, w koszyku, w mini-koszyku i na stronie zamówienia. Przyciski na stronie produktu skracają drogę do zakupu, ale przy wielu wariantach produktu mogą wprowadzać w błąd.

Wygląd (kolor, kształt, etykieta) ustawisz w sekcji stylu przycisków. Trzymaj się jednego stylu w całym sklepie — klienci rozpoznają przycisk PayPal po charakterystycznym, żółtym kolorze.

Jeśli Twoi klienci płacą głównie BLIK-iem i szybkimi przelewami, PayPal warto traktować jako uzupełnienie polskiej bramki płatności, a nie jedyną metodę. Do kart możesz też dodać drugą bramkę — zobacz poradnik Stripe dla WooCommerce.

Krok 4: test w trybie sandbox

Nigdy nie uruchamiaj płatności na produkcji bez testu. PayPal ma osobne środowisko testowe (sandbox), w którym nie przepływają prawdziwe pieniądze.

1. Zaloguj się na developer.paypal.com kontem PayPal i przejdź do sekcji kont testowych sandbox. Domyślnie znajdziesz tam testowe konto sprzedawcy (Business) i kupującego (Personal) — możesz też utworzyć nowe.
2. W ustawieniach wtyczki włącz tryb sandbox i połącz go z testowym kontem sprzedawcy, tak jak w kroku 2.
3. W oknie prywatnym przeglądarki dodaj produkt do koszyka i zapłać, logując się testowym kontem kupującego.
4. Sprawdź, czy zamówienie w WooCommerce zmieniło status na W trakcie realizacji (dla produktów fizycznych) lub Zrealizowane (dla produktów wirtualnych i do pobrania), a w panelu sandbox PayPal pojawiła się transakcja.
5. Przetestuj zwrot (krok 5) i dopiero wtedy wyłącz tryb sandbox i połącz konto produkcyjne.

Najlepiej testować na kopii sklepu (środowisko staging), żeby testowe zamówienia nie mieszały się z prawdziwymi i nie wysyłały e-maili do klientów.

Krok 5: zwroty, statusy zamówień i webhooki

Zwrot robisz w WooCommerce, nie w panelu PayPal:

1. Otwórz zamówienie w WooCommerce → Zamówienia.
2. Kliknij Zwrot, wpisz kwotę lub zaznacz pozycje.
3. Wybierz przycisk zwrotu przez PayPal (nie „ręczny zwrot”). Środki wrócą do klienta, a w notatkach zamówienia pojawi się identyfikator transakcji zwrotu.

Statusy zamówień aktualizują się dzięki webhookom — PayPal wysyła do sklepu powiadomienia o zmianach płatności. Wtyczka rejestruje je automatycznie przy łączeniu konta. Jeśli zamówienia zostają w statusie „Oczekujące na płatność” mimo udanej płatności, w ustawieniach połączenia wtyczki sprawdź status webhooków i użyj opcji ich ponownej subskrypcji.

Uwaga: Potwierdzenie z PayPal nie jest fakturą VAT ani paragonem. Obowiązki podatkowe (faktury, ewidencja sprzedaży, ewentualnie paragony) realizujesz po stronie sklepu lub systemu księgowego, niezależnie od bramki płatności.

Najczęstsze problemy z PayPal w WooCommerce i rozwiązania

Przyciski PayPal się nie wyświetlają

• Optymalizacja JavaScript. Wtyczki typu „połącz/opóźnij JS” (WP Rocket, LiteSpeed Cache, Autoptimize itp.) potrafią zepsuć ładowanie skryptu PayPal SDK. Dodaj skrypty PayPal i wtyczki PayPal Payments do wykluczeń.
• Cache strony. Wyklucz z cache stronę koszyka, zamówienia i konta — to standardowe ustawienie dla WooCommerce, ale warto je sprawdzić.
• Waluta. Jeśli waluta sklepu nie jest obsługiwana przez PayPal, przyciski nie pojawią się wcale.
• Konflikt z motywem lub innym checkoutem. Przełącz tymczasowo na domyślny motyw (np. Storefront lub motyw Twenty) i sprawdź, czy problem znika.

Otwórz konsolę przeglądarki (F12 → Console) — błędy związane z paypal.com/sdk/js zwykle wskazują winowajcę.

Zamówienia wstrzymane lub płatności „oczekujące”

Status Wstrzymane pojawia się m.in. wtedy, gdy PayPal oznaczy płatność do ręcznej weryfikacji albo gdy kupujący zapłacił w walucie, której nie masz włączonej na koncie PayPal. Zaloguj się do PayPal, sprawdź szczegóły transakcji i — jeśli trzeba — zaakceptuj płatność lub dodaj walutę do salda.

Błędy połączenia i logi

Włącz logowanie w ustawieniach wtyczki, a następnie sprawdź logi w WooCommerce → Status → Logi (wybierz plik z nazwą PayPal). Przy błędach PHP pomoże też tryb debugowania WordPressa. Jeśli problem dotyczy samego połączenia, odłącz konto w ustawieniach wtyczki i połącz je ponownie.

Czy PayPal wystarczy jako jedyna metoda płatności w polskim sklepie

PayPal sprawdza się przy sprzedaży zagranicznej i dla klientów, którzy nie chcą podawać danych karty w nowym sklepie. W Polsce większość kupujących oczekuje jednak BLIK-a i szybkich przelewów, więc dla sklepu nastawionego na rynek krajowy PayPal powinien być jedną z kilku metod.

Rozsądny zestaw dla małego sklepu to: lokalna bramka z BLIK-iem i przelewami, PayPal dla klientów zagranicznych i tych, którzy go preferują, oraz płatność kartą. Pamiętaj też, że każda zewnętrzna bramka ładuje własne skrypty — jeśli korzystasz z banera cookies i Google Analytics, sprawdź, jak wpisują się w Consent Mode v2. Żeby zamówienia opłacone PayPalem trafiały do GA4 jako zdarzenie purchase, przekazuj dane transakcji przez warstwę danych w Google Tag Manager. A gdy płatności już działają, zadbaj o ruch do sklepu — pomoże w tym poradnik SEO dla sklepu internetowego.