Konfiguracja Stripe dla sklepu PL i DE: pełny przewodnik wdrożenia

Jedno konto Stripe obsłuży sklep PL i DE oraz wiele walut
Klucze test (pk_test, sk_test) do prób, live (pk_live, sk_live) do produkcji
Webhook to warunek automatycznej aktualizacji statusu zamówienia
Karty, Apple Pay, Google Pay, a przez Stripe także BLIK i Klarna
Prowizja za karty europejskie startuje około 1,5% plus stała opłata
3D Secure i SCA obowiązkowe w UE, Stripe obsługuje je automatycznie
[/dwb_keytakeaways]

Dlaczego Stripe do sklepu na dwa rynki

Stripe to światowy standard płatności online i najlepiej sprawdza się tam, gdzie sprzedajesz na więcej niż jeden rynek. W jednej integracji dostajesz karty międzynarodowe, Apple Pay i Google Pay, a przez mechanizm metod płatności także Klarna i BLIK. Dla sklepu, który celuje jednocześnie w Polskę i Niemcy, to wygodne, bo nie żonglujesz osobnymi bramkami dla każdego kraju.

Trzeba jednak od razu ustawić oczekiwania. W sklepie tylko na Polskę Stripe nie zastąpi w pełni lokalnej bramki, bo nie daje polskich szybkich przelewów pay-by-link w takiej formie jak Przelewy24, PayU czy Tpay. Dlatego w czysto polskim sklepie często łączę Stripe z lokalną bramką. Gdy w grę wchodzą Niemcy i reszta Unii, Stripe jako fundament ma sens, bo karty i Klarna są tam metodami pierwszego wyboru.

W tym przewodniku przechodzę przez całe wdrożenie: założenie i weryfikację konta, klucze API, tryb test i live, webhooki, dobór metod płatności, prowizje, 3D Secure pod SCA, przewalutowanie, wypłaty i najczęstsze błędy, które potem generują chaos w zamówieniach.

Założenie i weryfikacja konta Stripe

Konto Stripe zakładasz na stronie stripe.com, na dane firmy z kraju, w którym jest ona zarejestrowana. Polska spółka lub jednoosobowa działalność zakłada konto w Polsce, niemiecka GmbH w Niemczech. Jedno konto obsłuży sprzedaż w wielu krajach i walutach, więc nie potrzebujesz osobnych kont dla PL i DE, dopóki masz jeden podmiot prawny.

Po rejestracji Stripe poprosi o dane do weryfikacji firmy (proces KYC, czyli poznaj swojego klienta). To standard wymagany prawem, nie da się go pominąć.

• Dane firmy: nazwa, adres, numer rejestrowy (NIP w Polsce, Steuernummer lub USt-IdNr w Niemczech).
• Dane właściciela i osób zarządzających: imię, nazwisko, data urodzenia, czasem dokument tożsamości.
• Numer konta bankowego: na nie Stripe będzie wypłacał środki, najlepiej konto firmowe w walucie wypłaty.
• Opis działalności: co sprzedajesz, bo Stripe ocenia ryzyko branży.

Weryfikacja zwykle trwa od kilku minut do dwóch dni roboczych. Do czasu jej zakończenia możesz pracować w trybie test, więc nie musisz czekać z konfiguracją sklepu.

Klucze API: test i live

Stripe komunikuje się ze sklepem przez klucze API. Każde konto ma dwa zestawy kluczy i to rozróżnienie jest sednem bezpiecznego wdrożenia.

• Klucz publiczny (zaczyna się od pk_): używany po stronie przeglądarki, bezpieczny do pokazania.
• Klucz tajny (zaczyna się od sk_): używany po stronie serwera, nigdy nie trafia do kodu w repozytorium ani na widok publiczny.

Do tego dochodzi rozróżnienie środowiska. Klucze testowe mają w nazwie test (pk_test, sk_test), a produkcyjne live (pk_live, sk_live). Klucze znajdziesz w panelu Stripe w sekcji Developers, zakładka API keys. W oficjalnej wtyczce Stripe dla WooCommerce wklejasz oba zestawy w odpowiednie pola, a przełącznik trybu decyduje, który jest aktywny.

Najważniejsza zasada: klucz tajny live to dane wrażliwe na poziomie hasła do banku. Nie wklejaj go do plików commitowanych do repozytorium, nie wysyłaj mailem otwartym tekstem. W produkcji trzymaj go w ustawieniach wtyczki lub w zmiennej środowiskowej na serwerze.

Tryb test: zanim ruszysz z prawdziwymi pieniędzmi

Tryb test to powód, dla którego wdrożenie Stripe jest bezpieczne. Z kluczami testowymi przeklikujesz całe zamówienie tak jak klient, ale bez ruszania prawdziwych pieniędzy. Stripe udostępnia testowe numery kart, które symulują różne scenariusze.

1. Karta udana: numer 4242 4242 4242 4242 z dowolną przyszłą datą i dowolnym CVC, płatność przechodzi.
2. Karta z 3D Secure: osobne numery testowe wymuszają ekran uwierzytelnienia, sprawdzasz przepływ SCA.
3. Karta odrzucona: numer kończący się na 0002 zwraca odmowę, sprawdzasz komunikat błędu dla klienta.

W trybie test przeklikaj złożenie zamówienia, sprawdź, czy status w WooCommerce zmienia się na opłacony, czy mail z potwierdzeniem wychodzi i czy zamówienie pojawia się w panelu Stripe. Dopiero gdy to działa, przełączasz się na live.

Webhooki: serce automatyzacji

Webhook to adres w Twoim sklepie, pod który Stripe wysyła powiadomienie o zdarzeniu, na przykład o udanej płatności. Bez działającego webhooka pieniądze przychodzą, ale sklep nie wie, że zamówienie zostało opłacone, więc status nie zmienia się automatycznie. To najczęstsze źródło chaosu w zamówieniach, jakie widzę przy źle wdrożonym Stripe.

Webhook konfigurujesz w panelu Stripe, w sekcji Developers, zakładka Webhooks. Dodajesz endpoint, czyli adres sklepu (zwykle podaje go oficjalna wtyczka, kończy się na fragmencie typu /wc-api/wc_stripe), i wybierasz zdarzenia do nasłuchu. Stripe wygeneruje sekret webhooka (zaczyna się od whsec_), który wklejasz do ustawień wtyczki, żeby sklep weryfikował autentyczność powiadomień.

Metody płatności: karty, portfele, Klarna, BLIK

Siłą Stripe jest mechanizm Payment Methods: jedno konto, a metody włączasz w panelu zależnie od rynku i waluty. Dla sklepu PL i DE warto przemyśleć zestaw pod każdy kraj.

• Karty (Visa, Mastercard): podstawa na obu rynkach, działają w PLN i EUR.
• Apple Pay i Google Pay: szybka płatność jednym dotknięciem, mocno podnoszą konwersję na telefonie. Wymagają weryfikacji domeny w panelu Stripe.
• Klarna: kup teraz, zapłać później. W Niemczech to metoda pierwszego wyboru dla dużej części klientów, w Polsce zyskuje na popularności. Przez Stripe dostajesz ją bez osobnej umowy z Klarna.
• BLIK: w polskim sklepie metoda numer jeden. Stripe obsługuje BLIK dla transakcji w PLN, włączasz go w ustawieniach metod.

Dla niemieckiego sklepu zestaw to zwykle karty, Apple Pay, Google Pay i Klarna, czasem SEPA i PayPal obok Stripe. Dla polskiego: karty, BLIK, Apple Pay, Google Pay i często Klarna, a lokalna bramka dokłada szybkie przelewy. Po włączeniu każdej metody zrób test, bo dostępność zależy od kraju konta i waluty.

Prowizje, 3D Secure i przewalutowanie

Koszt Stripe to przede wszystkim prowizja od transakcji, bo nie ma abonamentu ani opłaty aktywacyjnej. Stawki różnią się zależnie od pochodzenia karty i waluty.

1. Karty europejskie: prowizja startuje zwykle około 1,5% plus stała opłata kilkudziesięciu groszy za transakcję.
2. Karty spoza Europy: wyższa, zwykle w okolicach 2,5-3,3% plus opłata stała, bo wiążą się z większym ryzykiem i kosztem.
3. Przewalutowanie: gdy klient płaci w innej walucie niż waluta wypłaty, Stripe dolicza dopłatę za przewalutowanie, zwykle około 2%.

To stawki orientacyjne, traktuj je jako punkt startowy. Realny koszt zależy od wersji cennika, wolumenu i ustaleń, a przy dużym obrocie warto pytać o indywidualne stawki.

Osobna sprawa to bezpieczeństwo płatności. W Unii Europejskiej obowiązuje SCA (silne uwierzytelnianie klienta), które w praktyce oznacza 3D Secure: klient potwierdza płatność w aplikacji banku lub kodem. Dobra wiadomość jest taka, że Stripe obsługuje to automatycznie i sam decyduje, kiedy wymusić uwierzytelnienie. Nie musisz tego kodować, ale musisz przetestować przepływ na testowej karcie z 3D Secure, żeby mieć pewność, że ekran banku wyświetla się poprawnie.

Wypłaty środków

Stripe nie przekazuje pieniędzy natychmiast na Twoje konto. Środki najpierw trafiają do salda Stripe, a stamtąd są wypłacane na konto bankowe według ustalonego harmonogramu. Domyślnie wypłaty są automatyczne i przychodzą z opóźnieniem kilku dni roboczych, które na nowym koncie bywa dłuższe, a potem się skraca.

Harmonogram wypłat ustawiasz w panelu Stripe: codziennie, tygodniowo lub miesięcznie. Możesz też przejść na wypłaty ręczne, jeśli chcesz pełną kontrolę nad momentem transferu. Przy sklepie na dwa rynki i wielu walutach Stripe może wypłacać w walucie salda, więc warto mieć konto bankowe obsługujące EUR, jeśli sprzedajesz dużo do Niemiec, by uniknąć podwójnego przewalutowania.

Najczęstsze błędy wdrożenia

Po wielu wdrożeniach widać, że problemy powtarzają się w tych samych miejscach. Oto lista kontrolna, którą przechodzę przed oddaniem sklepu z Stripe.

Trzy błędy odpowiadają za większość zgłoszeń. Pierwszy to zostawiony tryb test na produkcji, przez co realne płatności w ogóle nie dochodzą. Drugi to brak webhooka produkcyjnego, przez co płatność przechodzi, ale zamówienie zostaje nieopłacone. Trzeci to klucz tajny live wklejony tam, gdzie nie powinien, na przykład w pliku commitowanym do repozytorium, co jest realnym zagrożeniem bezpieczeństwa. Wszystkie trzy łatwo przeoczyć i wszystkie łatwo naprawić, jeśli wiesz, gdzie patrzeć.

Jeśli stawiasz sklep na Polskę i Niemcy albo chcesz uporządkować istniejącą integrację Stripe, w DawidWeb robię to regularnie: konfiguracja konta i metod pod oba rynki, poprawne webhooki, testy 3D Secure i wpięcie Klarna oraz BLIK, żeby zamówienia księgowały się same. Strony i sklepy buduję od 1800 zł, jestem Partnerem Shoper, mam za sobą ponad 120 projektów, a wycenę konkretnego wdrożenia dostajesz w 24 godziny.