Stripe dla WooCommerce — konfiguracja krok po kroku (karty, BLIK, Apple Pay, webhooki)

Żeby skonfigurować Stripe w WooCommerce, zainstaluj bezpłatną wtyczkę „WooCommerce Stripe Payment Gateway”, połącz ją z kontem Stripe w zakładce WooCommerce → Ustawienia → Płatności, włącz wybrane metody płatności i sprawdź, czy działają webhooki. Całość zajmuje kilkanaście minut, a najwięcej czasu zwykle pochłania weryfikacja firmy w samym Stripe.

Poniżej znajdziesz pełną konfigurację krok po kroku, ustawienia przydatne w polskim sklepie (BLIK, Przelewy24, PLN), procedurę testów oraz rozwiązania najczęstszych problemów.

Co jest potrzebne przed konfiguracją Stripe w WooCommerce

Zanim zaczniesz, przygotuj:

• aktualny WordPress i WooCommerce — wtyczka Stripe wspiera zwykle kilka ostatnich wersji WooCommerce; na starym sklepie może się nie zainstalować,
• certyfikat SSL — strona zamówienia musi działać po HTTPS, inaczej Stripe nie pozwoli przyjmować płatności w trybie produkcyjnym,
• konto Stripe z ukończoną weryfikacją — dane firmy (lub jednoosobowej działalności), NIP, dane osoby reprezentującej, numer rachunku do wypłat,
• walutę sklepu ustawioną w WooCommerce → Ustawienia → Ogólne (dla polskich klientów zwykle PLN).

Rejestrację konta w Stripe możesz zacząć wcześniej — sklep da się połączyć i testować, zanim Stripe zatwierdzi dane firmy. Wypłaty zostaną jednak odblokowane dopiero po weryfikacji.

Krok 1: instalacja wtyczki WooCommerce Stripe Payment Gateway

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

To oficjalna integracja rozwijana przez zespół WooCommerce we współpracy ze Stripe. W katalogu znajdziesz też wtyczki innych firm z podobną nazwą — o nich piszę dalej.

Krok 2: połączenie sklepu z kontem Stripe

1. Przejdź do WooCommerce → Ustawienia → Płatności.
2. Przy pozycji Stripe kliknij Zarządzaj (lub „Complete setup”, zależnie od wersji WooCommerce).
3. Wybierz opcję utworzenia lub połączenia konta (Create or connect an account). Zostaniesz przekierowany do Stripe, gdzie logujesz się i zatwierdzasz połączenie.
4. Po powrocie do sklepu wtyczka sama zapisze klucze i zwykle sama skonfiguruje webhooki.
5. Osobno połącz konto w trybie testowym (przycisk Create or connect a test account), jeśli chcesz najpierw przetestować sklep.

Ręczne wpisanie kluczy API (opcja zaawansowana)

Jeśli połączenie przyciskiem nie działa (np. przez restrykcje serwera), możesz wpisać klucze ręcznie. Znajdziesz je w panelu Stripe w sekcji Developers → API keys:

Uwaga: Klucz tajny (sk_live_…) daje pełny dostęp do Twojego konta Stripe, w tym do zwrotów i danych klientów. Nie wysyłaj go mailem ani na czacie, nie wklejaj do zgłoszeń supportu. Jeśli wyciekł, natychmiast wygeneruj nowy w panelu Stripe (Roll key).

Krok 3: wybór metod płatności dla polskiego klienta

W ustawieniach wtyczki znajdziesz listę metod płatności, które możesz włączać i wyłączać. Część z nich musi być też aktywna w panelu Stripe (Settings → Payment methods).

Rozsądny zestaw dla sklepu w Polsce:

• Karty płatnicze (Visa, Mastercard) — podstawa, obsługiwana od razu.
• BLIK — najpopularniejsza metoda płatności online w Polsce; w Stripe dostępna dla transakcji w PLN.
• Przelewy24 — szybkie przelewy z polskich banków, w PLN i EUR.
• Apple Pay i Google Pay — w wtyczce występują jako płatności ekspresowe (express checkout); przycisk pojawia się tylko na urządzeniach i w przeglądarkach, które je obsługują.
• Link — zapisywanie danych karty przez Stripe, przyspiesza kolejne zakupy.

Dostępność poszczególnych metod zależy od wersji wtyczki, kraju rejestracji Twojego konta i waluty sklepu. Jeśli nie widzisz BLIK-a lub Przelewy24 na liście, zaktualizuj wtyczkę i sprawdź w panelu Stripe, czy metoda jest aktywna dla Twojego konta.

Wskazówka: Lokalne metody płatności (BLIK, Przelewy24) wyświetlają się tylko wtedy, gdy waluta koszyka jest zgodna z wymaganą przez daną metodę. Jeśli sklep działa w EUR, BLIK się nie pojawi.

Krok 4: webhooki — sprawdź, czy działają

Webhook to powiadomienie, które Stripe wysyła do Twojego sklepu, gdy zmieni się status płatności: płatność potwierdzona, odrzucona, zwrócona, otwarty spór (chargeback). Dla metod asynchronicznych, takich jak przelewy, to jedyny sposób, by sklep dowiedział się o zaksięgowaniu wpłaty.

Przy połączeniu przyciskiem wtyczka konfiguruje webhooki automatycznie. Jeśli wpisywałeś klucze ręcznie:

1. W panelu Stripe przejdź do Developers → Webhooks i dodaj endpoint.
2. Jako adres podaj:

https://twoj-sklep.pl/?wc-api=wc_stripe

3. Wybierz zdarzenia wskazane w ustawieniach wtyczki (wtyczka wyświetla adres i listę wymaganych zdarzeń) albo zaznacz wszystkie zdarzenia.
4. Skopiuj Signing secret (whsec_…) i wklej go w ustawieniach wtyczki w polu sekretu webhooka.
5. Wykonaj testową płatność i sprawdź w panelu Stripe, czy zdarzenia mają status dostarczenia 200.

Krok 5: testy przed uruchomieniem sprzedaży

1. W ustawieniach wtyczki włącz tryb testowy (Test mode).
2. Złóż zamówienie w sklepie, płacąc kartą testową 4242 4242 4242 4242, z dowolną przyszłą datą ważności i dowolnym CVC.
3. Przetestuj kartę wymagającą uwierzytelnienia 3D Secure: 4000 0025 0000 3155 — powinno pojawić się okno potwierdzenia.
4. Przetestuj odrzucenie: karta 4000 0000 0000 0002 zwraca błąd „card declined”.
5. Sprawdź, czy zamówienie w WooCommerce zmieniło status na „W trakcie realizacji” i czy przyszedł e-mail do klienta.
6. Zrób zwrot z poziomu zamówienia w WooCommerce i sprawdź, czy pojawił się w panelu Stripe.
7. Przetestuj metody lokalne (BLIK, Przelewy24) — w trybie testowym Stripe pokazuje stronę, na której symulujesz akceptację lub odrzucenie płatności.

Dopiero gdy wszystko działa, wyłącz tryb testowy. Pamiętaj, że klienci i karty zapisane w trybie testowym nie istnieją w trybie produkcyjnym.

Uwierzytelnianie 3D Secure jest w Europejskim Obszarze Gospodarczym wymagane przez dyrektywę PSD2 (silne uwierzytelnianie klienta, SCA). Wtyczka obsługuje je automatycznie, więc nie musisz niczego programować — ale musisz je przetestować.

Bezpieczeństwo i PCI DSS

Formularz karty w oficjalnej wtyczce jest generowany przez Stripe (Stripe Elements / Payment Element) i ładowany z serwerów Stripe. Dane karty nie przechodzą przez Twój serwer, co znacznie upraszcza zgodność ze standardem PCI DSS — w większości przypadków sklep wypełnia tylko uproszczony kwestionariusz samooceny.

Nie zwalnia Cię to z dbania o sam sklep. Skompromitowany WordPress może podmienić skrypty na stronie zamówienia (tzw. skimming). Dlatego:

• aktualizuj WordPress, WooCommerce i wszystkie wtyczki,
• używaj silnych haseł i 2FA dla kont administratorów,
• ogranicz liczbę wtyczek ładowanych na stronie zamówienia,
• rozważ zaporę aplikacyjną — o tym, jak działa, przeczytasz w tekście co to jest WAF.

Najczęstsze problemy ze Stripe w WooCommerce

Zamówienia „wiszą” w statusie oczekiwania na płatność

To niemal zawsze problem z webhookami. W panelu Stripe (Developers → Webhooks → Twój endpoint) zobaczysz nieudane próby dostarczenia z kodem błędu. Typowe przyczyny:

• wtyczka bezpieczeństwa lub zapora (np. reguły Cloudflare) blokuje zapytania od Stripe — kod 403; zobacz poradnik o błędzie 403 Forbidden w WordPressie,
• tryb konserwacji lub ochrona hasłem całej strony,
• zły sekret webhooka (np. testowy w trybie produkcyjnym).

Przyciski Apple Pay / Google Pay się nie wyświetlają

Sprawdź, czy płatności ekspresowe są włączone w ustawieniach wtyczki i na których stronach mają się pojawiać (produkt, koszyk, zamówienie). Apple Pay wymaga zweryfikowanej domeny w Stripe — wtyczka robi to automatycznie, ale przy niestandardowej konfiguracji serwera warto sprawdzić status domeny w panelu Stripe. Przycisk Apple Pay zobaczysz tylko w Safari na urządzeniu z skonfigurowanym Apple Pay.

Formularz karty się nie ładuje lub checkout „kręci się” w nieskończoność

Zwykle to konflikt JavaScriptu z inną wtyczką lub agresywna optymalizacja (łączenie i opóźnianie skryptów, cache strony zamówienia). Wyklucz strony koszyka i zamówienia z cache, wyłącz minifikację JS dla skryptów Stripe i sprawdź konsolę przeglądarki (F12). Więcej o szukaniu przyczyn znajdziesz w poradniku o trybie debugowania WordPressa.

Błąd „No such customer” lub „No such payment method”

Pojawia się po przełączeniu sklepu z trybu testowego na produkcyjny (lub po zmianie konta Stripe), gdy klient ma zapisane dane z poprzedniego trybu. Rozwiązanie to usunięcie zapisanej metody płatności u klienta i ponowna płatność.

Gdzie szukać logów

Włącz logowanie w ustawieniach wtyczki (opcja „Log debug messages”), a logi znajdziesz w WooCommerce → Status → Logi, w pliku z nazwą zaczynającą się od woocommerce-gateway-stripe. Ważne komunikaty widać też w panelu Stripe w zakładce Developers → Logs.

Inne wtyczki Stripe i alternatywy dla polskiego sklepu

Oficjalna wtyczka wystarcza większości sklepów. W katalogu WordPress.org znajdziesz też rozwiązania innych firm, np. „Payment Plugins for Stripe WooCommerce” czy wtyczkę Stripe od FunnelKit. Oferują one m.in. więcej opcji wyglądu formularza i integracje z kreatorami lejków sprzedażowych. Przed wyborem sprawdź datę ostatniej aktualizacji, zgodność z aktualnym WooCommerce i to, czy wtyczka obsługuje potrzebne Ci metody płatności.

Do sklepów z subskrypcjami potrzebne jest płatne rozszerzenie WooCommerce Subscriptions — oficjalna wtyczka Stripe obsługuje płatności cykliczne razem z nim.

Stripe nie jest jedyną opcją. Polskie sklepy często łączą go z lokalnymi bramkami (Przelewy24, PayU, Tpay) albo z PayPalem — konfigurację tego ostatniego opisaliśmy w poradniku PayPal w WooCommerce. Przed wyborem porównaj aktualne cenniki prowizji (stawki zależą od rodzaju karty i metody płatności) oraz harmonogram wypłat na konto bankowe.

Lista kontrolna przed włączeniem płatności na produkcji

1. Konto Stripe zweryfikowane, rachunek do wypłat w PLN dodany.
2. Wtyczka połączona w trybie produkcyjnym, tryb testowy wyłączony.
3. Webhook produkcyjny z poprawnym sekretem, ostatnie zdarzenia dostarczone z kodem 200.
4. Włączone metody płatności zgodne z walutą sklepu.
5. Testowa płatność prawdziwą kartą na niską kwotę i zwrot z poziomu WooCommerce.
6. Strony koszyka i zamówienia wykluczone z cache.
7. Regulamin sklepu zawiera informację o dostępnych metodach płatności i operatorze płatności.

Gdy sklep już przyjmuje płatności, zadbaj o ruch — praktyczne porady znajdziesz w tekście SEO dla sklepu internetowego. Żeby wiedzieć, które kanały faktycznie sprzedają, skonfiguruj pomiar zakupów w GA4 przez Data Layer w Google Tag Manager.