Jeżeli Stripe jest włączony w WooCommerce, ale klient nie widzi go przy kasie, samo ponowne zapisanie kluczy API zwykle nie wystarczy. Bramka może zniknąć przez cache metod płatności, niezgodny szablon checkoutu, konflikt wtyczki, problem z HTTPS albo brak kompatybilności z Checkout Block.
Najlepsza diagnostyka polega na ustaleniu, czy problem dotyczy Stripe w ogóle, konkretnej metody płatności, konkretnego urządzenia, czy tylko nowego blokowego checkoutu WooCommerce.
Najpierw ustal zakres problemu
Zanim zmienisz konfigurację, wykonaj cztery testy:
- Otwórz checkout w trybie prywatnym przeglądarki.
- Sprawdź inne urządzenie lub przeglądarkę.
- Sprawdź, czy brakuje całego Stripe, czy tylko jednej metody, np. karty lub portfela.
- Sprawdź, czy problem występuje dla każdego produktu i kraju dostawy.
Jeśli problem występuje tylko w jednej przeglądarce, podejrzewaj cache lub skrypt. Jeżeli Stripe znika wszędzie, przejdź do konfiguracji WooCommerce.
1. Odśwież cache metod płatności Stripe
WooCommerce informuje w oficjalnej dokumentacji Stripe, że formularz checkoutu buforuje listę aktywnych metod płatności, a cache odświeża się okresowo. Po zmianie ustawień nowa metoda może więc nie pojawić się natychmiast.
Wejdź w WooCommerce → Settings → Payments → Stripe → Payment Methods, odśwież stronę ustawień i zapisz konfigurację. Jeżeli korzystasz z cache strony, CDN lub systemu optymalizacji skryptów, wyczyść również ich pamięć dla checkoutu.
Strony koszyka, checkoutu i konta klienta nie powinny być agresywnie cachowane jak zwykły wpis blogowy.
2. Sprawdź HTTPS i certyfikat
WooCommerce zaleca działający SSL w trybie produkcyjnym. Otwórz checkout i sprawdź:
- czy adres zaczyna się od
https://; - czy przeglądarka nie pokazuje błędu certyfikatu;
- czy zasoby strony nie są ładowane częściowo przez HTTP;
- czy przekierowania nie przerzucają checkoutu między wersją www i bez www.
W sklepie działającym na rynku UK HTTPS jest nie tylko wymaganiem technicznym bramki. Brak poprawnego certyfikatu natychmiast obniża zaufanie klienta na najbardziej wrażliwym etapie zakupu.
3. Sprawdź, czy używasz Checkout Block
WooCommerce od kilku wersji szeroko wykorzystuje blokowy koszyk i checkout. To ważne, ponieważ bramka płatności musi obsługiwać interfejs blokowego checkoutu. Wtyczka, która działała w klasycznym shortcode [woocommerce_checkout], nie musi automatycznie pojawić się w Checkout Block.
Jeżeli po zmianie motywu lub przebudowie strony płatności zniknęły:
- sprawdź, czy checkout został zmieniony z klasycznego na blokowy;
- sprawdź wersję WooCommerce Stripe Gateway;
- zaktualizuj WooCommerce i bramkę do zgodnych stabilnych wersji;
- sprawdź dokumentację każdej dodatkowej metody płatności pod kątem Blocks.
Nie przełączaj produkcyjnego checkoutu bez kopii zapasowej i testu pełnego zamówienia.
4. Motyw i wtyczki: wykonaj kontrolowany conflict test
Oficjalna dokumentacja WooCommerce wskazuje konflikt motywu lub wtyczki jako jedną z częstszych przyczyn braku Stripe przy kasie.
Na kopii stagingowej:
- przełącz motyw na domyślny zgodny z WooCommerce;
- wyłącz wtyczki niezwiązane z WooCommerce i Stripe;
- sprawdź checkout;
- włączaj dodatki pojedynczo, aż problem wróci.
Szczególnie podejrzane są wtyczki modyfikujące checkout, waluty, ceny, cache, optymalizację JavaScript, zgodę cookies i metody płatności.
Sprawdź przestarzałe szablony WooCommerce
W WooCommerce → Status zobacz sekcję templates. Motyw może nadpisywać starsze pliki checkoutu. Po aktualizacji WooCommerce stary override potrafi nadal się ładować, mimo że sam plugin jest aktualny.
5. Włącz logowanie i przeczytaj log Stripe
Zamiast zgadywać, włącz logging w ustawieniach Stripe, wykonaj próbę wejścia do checkoutu i sprawdź logi WooCommerce. Szukaj błędów związanych z:
- tworzeniem PaymentIntent;
- nieprawidłowym kluczem lub trybem test/live;
- nieobsługiwaną walutą;
- metodą płatności niedostępną dla danego rynku;
- błędami JavaScript;
- odpowiedzią API Stripe.
Log jest znacznie bardziej użyteczny niż komunikat klienta „nie mam płatności”, bo pokazuje, czy WooCommerce w ogóle próbował zainicjować Stripe.
UK: sprawdź walutę i metody dostępne dla klienta
Sklep działający w Wielkiej Brytanii często pracuje w GBP, ale może sprzedawać też do UE. Nie każda metoda Stripe jest dostępna w każdej kombinacji kraju, waluty i konta. Jeśli karta działa, a znika tylko dodatkowa metoda, sprawdź jej warunki osobno.
Jeżeli dopiero budujesz lub przebudowujesz sprzedaż na tym rynku, zobacz również stronę sklep internetowy w UK — checkout, płatności i konwersja powinny być planowane jako jeden proces, a nie jako osobne wtyczki.
Minimalna kolejność naprawy
- tryb prywatny i drugi browser;
- odświeżenie konfiguracji i cache;
- HTTPS;
- aktualność WooCommerce i Stripe;
- Checkout Block vs klasyczny checkout;
- status przestarzałych templates;
- log Stripe;
- conflict test na stagingu.
Ta kolejność ogranicza ryzyko, że przez prosty problem z cache zaczniesz przebudowywać cały checkout.
FAQ
Stripe jest aktywny, ale nie widać go tylko na checkout. Dlaczego?
Najczęstsze obszary to cache metod płatności, motyw, konflikt wtyczki, HTTPS, przestarzałe szablony lub niekompatybilność z blokowym checkoutem.
Czy Checkout Block może ukryć bramkę płatności?
Tak, jeśli dana bramka lub jej rozszerzenie nie obsługuje Blocks. Sprawdź zgodność konkretnej wtyczki płatniczej.
Czy warto od razu usuwać i instalować Stripe ponownie?
Nie jako pierwszy krok. Najpierw sprawdź logi, cache, SSL, aktualność komponentów i konflikt. Reinstalacja bez diagnozy może pozostawić tę samą przyczynę.