Płatność Stripe przenosi klienta na bezpieczną stronę Stripe: karta, Apple Pay, Google Pay, Klarna, iDEAL, BLIK, SEPA i inne metody jego kraju. Sklep sam poznaje wynik od Stripe i nadaje zamówieniu status.
Kiedy to się przyda:
- Sprzedajesz w UE, Wielkiej Brytanii lub USA — Stripe pokazuje klientowi metody jego kraju.
- Klient płaci z konta przez SEPA — zamówienie czeka na potwierdzenie banku i samo staje się opłacone.
- Klient zmienił koszyk po przejściu do płatności — płatność innej kwoty nie zmieni statusu na „Opłacone”.
- Klient zakwestionował płatność w banku — zamówienie dostanie status, który wybierzesz.
Od czego zacząć: „Ustawienia sklepu” → „Zamówienie i płatność” → Stripe → klucze, adres webhooka i przełącznik „Włączony”.
Co potrafi płatność Stripe
- Przyjmuje płatność na stronie Stripe — metody, które włączysz w panelu Stripe i które pasują klientowi.
- Działa w trybie testowym — karty testowe, pieniądze nie są pobierane.
- Przechowuje klucze testowe i produkcyjne razem — przełącznik trybu wybiera, która para działa.
- Sama nadaje status zamówieniu — opłacone, czeka na bank, nieudane, zwrócone, zakwestionowane.
- Zwraca całą kwotę lub część — przyciskiem w karcie zamówienia Elbuz.
Jak podłączyć Stripe
Potrzebujesz konta Stripe Twojej firmy. Tryb testowy Stripe udostępnia od razu po rejestracji, jeszcze przed aktywacją płatności: moduł można skonfigurować i sprawdzić zawczasu.
- Otwórz ekran modułu. „Ustawienia sklepu” → sekcja „Zamówienie i płatność” → karta Stripe.
- W bloku „Połączenie” zostaw włączony „Tryb testowy” i skopiuj „Adres webhooka”.
- Utwórz webhook w panelu Stripe z tym adresem i zdarzeniami z pola „Zdarzenia webhooka” (poniżej).
- W karcie „Klucze testowe” wpisz „Testowy klucz tajny” i „Testowy klucz podpisu webhooka”.
- Włącz przełącznik „Włączony” u góry ekranu i kliknij „Zapisz”.
- Sprawdź płatnością testową, potem przejdź na tryb produkcyjny.
1
Karta Stripe2
Znacznik stanu: potrzebne klucze- Karta modułu płatności Stripe; kliknięcie otwiera ekran modułu.
- Czego brakuje modułowi: „potrzebne klucze”, dopóki nie wpiszesz kluczy bieżącego trybu.
1
Przełącznik „Włączony”2
Tryb testowy3
Adres webhooka4
Co jeszcze do skonfigurowania5
Tryb- Po zapisaniu pokazuje Stripe klientom.
- Płatności testowe bez pobierania pieniędzy; używana jest para kluczy testowych.
- Wklej ten adres do webhooka w panelu Stripe.
- Czego jeszcze brakuje, żeby płatności działały.
- Tryb, w którym teraz działają płatności.
Karta kluczy bieżącego trybu jest rozwinięta i oznaczona „używane teraz”, druga — zwinięta. Włączony moduł bez obu kluczy bieżącego trybu się nie zapisze: w polu pojawi się „Wymagane — bez tego moduł nie zadziała”.
Klucz z innego trybu, na przykład sk_live_… w polu testowym, się nie zapisze: przy polu pojawi się „Klucz testowy zaczyna się od sk_test_ lub rk_test_.” Jak działa okno w ogóle — w artykule „Ustawienia sklepu”.
Skąd wziąć klucze i jak utworzyć webhook
Dla każdego trybu potrzebne są dwie wartości: klucz tajny i klucz podpisu webhooka. Testowe i produkcyjne są różne. Tryb przełącza się u góry panelu Stripe (Test mode lub Sandbox).
Klucz tajny
Panel Stripe → Developers → API keys → Secret key → Reveal. Testowy zaczyna się od sk_test_, produkcyjny — od sk_live_. Produkcyjny klucz Stripe pokazuje w całości tylko raz: zachowaj kopię.
Pasuje też klucz ograniczony rk_test_… lub rk_live_…. Jakie uprawnienia mu nadać, opisano pod przyciskiem „Pomoc” na ekranie modułu.
Webhook i jego klucz podpisu
Webhook to adres sklepu, na który Stripe wysyła powiadomienia o płatnościach i zwrotach. Bez niego sklep nie dowie się, że klient zapłacił.
- W panelu Stripe: Workbench → Webhooks → Create an event destination.
- Wybierz Your account, format zdarzeń Snapshot.
- Zaznacz wszystkie 9 zdarzeń z pola „Zdarzenia webhooka”. Przycisk „Kopiuj wszystkie” skopiuje je razem.
- Typ — Webhook endpoint. W Endpoint URL wklej „Adres webhooka” z ekranu modułu i zapisz.
- Na stronie webhooka kliknij Reveal przy Signing secret i skopiuj
whsec_…do pola klucza podpisu.
1
Adres webhooka2
Zdarzenia webhooka3
Testowy klucz tajny4
Testowy klucz podpisu webhooka5
Używane teraz- Wklej w Endpoint URL webhooka w panelu Stripe.
- Zdarzenia do zaznaczenia w webhooku; „Kopiuj wszystkie” kopiuje je razem.
- Secret key z Developers → API keys w trybie testowym (sk_test_…).
- Signing secret testowego webhooka (whsec_…).
- Para kluczy używana w bieżącym trybie.
Dla trybu produkcyjnego powtórz to samo w trybie produkcyjnym panelu: tam jest osobny webhook i osobny klucz podpisu. Ochrona strony nie może blokować adresu webhooka, inaczej statusy nie będą się zmieniać.
Klucze po zapisaniu nie są pokazywane — w polu widać tylko, że są ustawione. Aby zmienić, kliknij „Zastąp” i wpisz nowy.
Jak sprawdzić płatnością testową
- Złóż zamówienie na siebie i wybierz Stripe. Przed przejściem pojawi się „Tryb testowy (Stripe): pieniądze nie są pobierane”.
- Na stronie Stripe zapłać kartą testową z tabeli. Data ważności — dowolna przyszła, CVC — dowolne trzy cyfry.
- Sprawdź zamówienie w Elbuz: status z pola „Opłacone”. Samą płatność widać w panelu Stripe w trybie testowym.
| Co wpisać | Co się stanie |
|---|---|
Karta 4242 4242 4242 4242 | Udana płatność |
Karta 4000 0000 0000 3220 | Płatność z potwierdzeniem 3-D Secure: w oknie kliknij Complete |
Karta 4000 0000 0000 0002 | Bank odmówił: klient zostaje na stronie Stripe i może spróbować inną kartę |
SEPA, IBAN DE89370400440532013000 | Najpierw „Czeka na bank”, potem „Opłacone” |
SEPA, IBAN DE62370400440532013001 | Najpierw „Czeka na bank”, potem „Płatność nieudana” |
SEPA jest widoczna tylko wtedy, gdy jest włączona w panelu Stripe, a zamówienie jest w euro.
Przejście na tryb produkcyjny
Dopóki tryb testowy jest włączony, po prawej widać „Włączony tryb testowy — pieniądze nie są pobierane. Wyłącz go przed sprzedażą”. Aby przyjmować prawdziwe pieniądze:
- W panelu Stripe dokończ aktywację: Activate payments, dane firmy i konto do wypłat.
- Utwórz webhook w trybie produkcyjnym panelu.
- W karcie „Klucze produkcyjne” wpisz „Produkcyjny klucz tajny” i „Produkcyjny klucz podpisu webhooka”.
- Wyłącz „Tryb testowy” i kliknij „Zapisz”. Wiersz „Tryb” po prawej pokaże „Tryb produkcyjny”.
Po przełączeniu sklep sam zamyka w Stripe niedokończone strony płatności starego trybu. Klucze testowe pozostają zapisane: gdy znów włączysz tryb testowy, będą na miejscu.
Co widzi klient i dla jakich zamówień
Przy składaniu zamówienia metoda nazywa się „Karta, Apple Pay, Google Pay i inne metody (Stripe)”. Po potwierdzeniu klient widzi „Przechodzimy na bezpieczną stronę płatności Stripe…” i trafia na stronę Stripe.
| Co się stało | Dokąd wraca klient |
|---|---|
| Zapłacił lub rozpoczął płatność odroczoną (SEPA) | Strona udanego zamówienia |
| Kliknął „Wstecz” na stronie Stripe | Składanie zamówienia bez komunikatu: koszyk i dane są na miejscu, zamówienie jest niepotwierdzone. Można zapłacić ponownie lub wybrać inną metodę |
| Wrócił bez płatności | Składanie zamówienia z komunikatem „Płatność nie została zakończona. Spróbuj ponownie lub wybierz inną metodę płatności…” |
| Nie udało się otworzyć strony płatności | Zostaje w sklepie z komunikatem „Nie udało się otworzyć strony płatności…” i przyciskiem „Zapłać” |
Jakie metody są widoczne na stronie Stripe, włączasz w panelu Stripe: Settings → Payments → Payment methods. Moduł ich nie ogranicza: Stripe pokazuje włączone metody pasujące do kraju klienta i waluty.
Kwota idzie w walucie zamówienia, bez przeliczania. Czy Twoje konto przyjmuje tę walutę, widać w panelu Stripe.
Język strony to główny język sklepu, jeśli Stripe go zna: angielski, niemiecki, polski, francuski i inne języki UE. Ukraińskiego Stripe nie ma, więc dla niego strona otwiera się w języku przeglądarki klienta.
Dla jakich zamówień pokazywać
Blok „Gdzie pokazywać” ogranicza, komu Stripe jest widoczny:
- „Strefa geograficzna” — płatność tylko dla klientów z adresem w tej strefie; „Wszystkie strefy” — dla wszystkich.
- „Minimalna kwota zamówienia” — Stripe pojawia się od tej kwoty w głównej walucie sklepu. Puste lub
0— zawsze. Kwot mniejszych niż około 0,50 EUR lub USD Stripe sam nie przyjmuje. - „Kolejność sortowania” — miejsce na liście płatności, mniejsza liczba jest wyżej.
Statusy zamówienia
Status nadaje sam sklep, gdy Stripe powiadamia o zdarzeniu. Jakie dokładnie — wybierasz w bloku „Statusy zamówienia”.
1
Opłacone2
Czeka na bank3
Płatność nieudana4
Zwrócono5
Zakwestionowana przez kupującego- Stripe potwierdził płatność pełnej kwoty.
- SEPA i inne metody odroczone, dopóki bank potwierdza.
- Bank nie potwierdził płatności odroczonej.
- Po zwrocie pełnej kwoty.
- Klient zakwestionował płatność w banku; domyślnie status się nie zmienia.
| Pole | Kiedy jest nadawany | Domyślnie |
|---|---|---|
| Opłacone | Stripe potwierdził płatność pełnej kwoty zamówienia. Klient dostaje zwykły e-mail o zamówieniu | „W realizacji” |
| Czeka na bank | SEPA i inne metody odroczone: klient zapłacił, bank potwierdza w ciągu kilku dni roboczych | „Oczekujące” |
| Płatność nieudana | Bank nie potwierdził płatności odroczonej | „Nieudane” |
| Zwrócono | Klientowi zwrócono całą kwotę | „Zwrócono środki” |
| Zakwestionowana przez kupującego | Klient zakwestionował płatność w swoim banku (chargeback) | „— zachowaj obecny status —” |
Dopóki klient nie zapłaci, zamówienie pozostaje niepotwierdzone. Nowa próba płatności zamyka poprzednią stronę Stripe: nie da się zapłacić dwa razy ze starej karty przeglądarki.
Płatność odroczoną widać po statusie z pola „Czeka na bank”. Nie wysyłaj, dopóki moduł nie ustawi „Opłacone”.
Spór z kwotą i powodem widać w panelu Stripe, tam też się na niego odpowiada. Jeśli w „Zakwestionowana przez kupującego” zostawisz „— zachowaj obecny status —”, status zamówienia się nie zmieni.
Kiedy status się nie zmienia
- Inna kwota. Klient zmienił koszyk po przejściu do płatności i zapłacił starą kwotę. Pieniądze wpłynęły, ale zamówienie pozostaje niepotwierdzone — porównaj kwotę w panelu Stripe.
- Druga płatność. Klient zapłacił za już opłacone zamówienie. Dwie płatności jednego zamówienia widać w panelu Stripe: nadmiarową zwróć.
- Nie ten tryb. Płatność testowa, gdy sklep jest w trybie produkcyjnym, nie opłaca zamówienia: pieniądze nie wpłynęły. Produkcyjna, gdy sklep jest w trybie testowym, — też nie, choć pieniądze są prawdziwe: znajdź ją w panelu Stripe.
- Fałszywe powiadomienie. Moduł sprawdza podpis kluczem webhooka i dopytuje Stripe o kwotę, walutę i tryb. Obce powiadomienie nie zmieni zamówienia.
- Zamówienie jest już opłacone. Płatność odroczona ani jej odrzucenie nie nadpisują statusu „Opłacone”.
Zwrot pieniędzy w karcie zamówienia
Zamówienie ze strony trafia do dokumentów „Zamówienie klienta” w Elbuz ze sposobem płatności „Karta płatnicza”. W jego karcie jest blok „Płatność w Stripe”: stan płatności, kwota, ile pobrano i zwrócono. Tam też widać, ile jeszcze można zwrócić, oraz wszystkie próby płatności z numerem w Stripe.
Widać tylko przyciski dostępne teraz dla zamówienia:
| Przycisk | Co robi |
|---|---|
| Zwróć środki | Zwraca klientowi całą kwotę lub jej część. Pole kwoty jest już wypełnione pozostałą kwotą: aby zwrócić wszystko, zostaw proponowaną kwotę |
| Odśwież status | Pobiera stan płatności ze Stripe, jeśli powiadomienie nie dotarło |
Zwracać można kilka razy, ale nie więcej, niż zostało. Stripe realizuje zwrot przez kilka minut: kwota w drodze nie wlicza się już do „Do zwrotu”.
| Zwrot | Co stanie się z zamówieniem |
|---|---|
| Całej kwoty | Status z pola „Zwrócono” |
| Części | Status bez zmian; zwróconą kwotę widać w bloku „Płatność w Stripe” |
| Stripe odmówił | Status bez zmian; przyczynę pokaże komunikat w karcie zamówienia |
Przed zwrotem program prosi o potwierdzenie z ostrzeżeniem „Tej operacji nie można cofnąć.”. Status zamówienia zmienia się tak samo jak po powiadomieniu Stripe, a w historii zamówienia pojawia się wpis z wynikiem.
Gdy sklep nie odpowie, program napisze „Nie wiadomo, czy operacja przeszła…” i pokaże „Powtórz”. Powtarza on tę samą operację: pieniądze nie zostaną przesunięte drugi raz. Ponowne kliknięcie przycisku to już nowa operacja.
Zwracać pieniądze może tylko użytkownik z uprawnieniem „Operacje płatności: zwrot, blokada, kredyt” — domyślnie właściciel. „Odśwież status” jest dostępne dla każdego, kto widzi zamówienie.
Na kartę pieniądze idą od razu i docierają do klienta w ciągu 5–10 dni. Zwrot SEPA i metod bankowych trwa kilka dni: status „Zwrócono” pojawi się, gdy Stripe go zakończy. Sklep nie wysyła klientowi e-maila o zwrocie.
Zwrotu wykonanego samodzielnie w panelu Stripe moduł nie śledzi: status zamówienia zmień sam.
Gdy przez Stripe były już zamówienia, nagłówek ekranu modułu pokazuje je za 30 dni: liczbę, kwotę, średnią wartość zamówienia i udział anulowanych lub zwróconych.
Scenariusze
AGD: klienci z Holandii płacą przez swój bank
W panelu Stripe włącz iDEAL i Bancontact, ceny na witrynie — w euro. Klient z Amsterdamu widzi iDEAL na stronie Stripe i płaci w aplikacji banku. Pralka dostaje status „Opłacone” bez Twojego udziału.
Monitory dla firmy z Austrii: płatność z konta
Włącz SEPA Direct Debit w panelu Stripe. W „Czeka na bank” wybierz status, przy którym magazyn nie wysyła. Firma wpisuje IBAN, a po kilku dniach zamówienie samo dostanie „Opłacone” lub „Płatność nieudana”.
Odzież: płatność z telefonu bez wpisywania karty
Sprawdź, czy w panelu Stripe są włączone Apple Pay i Google Pay. „Kolejność sortowania” — mniejsza niż w innych płatnościach, na przykład 0: Stripe będzie pierwszy. Klient z iPhone’em płaci Apple Pay, nie wpisując karty.
Witryna w dolarach dla USA obok euro
Dodaj walutę USD do sklepu i włącz w panelu Stripe potrzebne amerykańskie metody. Klient z USA płaci w dolarach, europejski — w euro. Jeden moduł na oba rynki.
Co zrobić, gdy płatność nie działa
| Co widzisz | Dlaczego tak jest | Co zrobić |
|---|---|---|
| Klient nie widzi Stripe przy składaniu zamówienia | Moduł jest wyłączony, brak klucza tajnego bieżącego trybu, kwota jest mniejsza od minimalnej albo adres jest poza strefą geograficzną | Sprawdź „Włączony”, klucze bieżącego trybu, „Minimalna kwota zamówienia” i „Strefa geograficzna”, potem „Zapisz” |
| Klient widzi „Nie udało się otworzyć strony płatności” | Stripe nie przyjął klucza, waluty zamówienia albo zbyt małej kwoty | Wklej klucz jeszcze raz z panelu Stripe. Nie pomogło — wsparcie Elbuz sprawdzi odpowiedź Stripe w dzienniku modułu |
| Płatność przeszła, a status się nie zmienił | Błędny klucz podpisu webhooka, webhook utworzono w innym trybie lub z innym adresem, adres blokuje ochrona strony | Kliknij „Odśwież status” w karcie tego zamówienia w Elbuz. Skopiuj Signing secret jeszcze raz. Sprawdź adres i zdarzenia webhooka w panelu Stripe: Workbench → Webhooks → Twój webhook → Event deliveries |
| Przy kluczu — „Klucz testowy zaczyna się od sk_test_…”, „Klucz produkcyjny zaczyna się od sk_live_…” lub „Signing secret zaczyna się od whsec_.” | Klucz z innego trybu albo wklejony ze spacją lub nie w całości | Klucz testowy — sk_test_…, produkcyjny — sk_live_…, klucz podpisu webhooka — whsec_…. Kopiuj przyciskiem w panelu Stripe |
| Zwrócono całą kwotę, a status nie zmienił się na „Zwrócono” | Zwrot na konto, a nie na kartę, jest jeszcze w Stripe | Poczekaj: status zmieni się, gdy Stripe zakończy zwrot. Postęp zwrotu widać w panelu Stripe |
| „Sklep nie przyjął ustawień” lub „Sklep nie przyjął części wartości — zobacz zaznaczone pola” | Sklep nie odpowiedział albo odrzucił niektóre pola | Popraw zaznaczone pola i zapisz. Jeśli pola nie są zaznaczone, zmiany pójdą z następnym eksportem |
Najczęstsze pytania
Czy Stripe może podłączyć firma z Ukrainy?
Moduł działa z każdym kontem Stripe. Czy Stripe otworzy konto Twojej firmie, decyduje Stripe według kraju jej rejestracji.
Czy potrzebny jest klucz publiczny pk_…?
Nie. Stronę płatności pokazuje sam Stripe, więc sklepowi wystarczy klucz tajny i klucz podpisu webhooka.
Co się stanie, jeśli wyłączę moduł?
Stripe zniknie z formularza zamówienia. Klucze i ustawienia zostają zachowane: po ponownym włączeniu wszystko jest na miejscu.
Czy można wysłać klientowi link do płatności Stripe z Elbuz?
Tak, ale to osobne połączenie Stripe w Elbuz, z własnym kluczem i własnym adresem powiadomień: Płatność przez link.
Na liście „Strefa geograficzna” nie ma potrzebnej strefy — co zrobić?
Strefę, na przykład „Holandia”, tworzy wsparcie Elbuz. Potem wybierz ją w bloku „Gdzie pokazywać”.
Jak zwrócić pieniądze klientowi?
Otwórz zamówienie w Elbuz i w bloku „Płatność w Stripe” kliknij „Zwróć środki”. Pole kwoty jest już wypełnione pozostałą kwotą: przy częściowym zwrocie wpisz mniejszą. Sklep nie wysyła klientowi e-maila o zwrocie.
Gdzie to jest i kto ma dostęp
- Menu
- Słowniki → Operacje → Ustawienia sklepu → „Zamówienie i płatność” → Stripe
- Uprawnienia
- okno „Ustawienia sklepu” w „Uprawnieniach grup”; zwroty — uprawnienie „Operacje płatności: zwrot, blokada, kredyt”
- Przygotuj
- konto Stripe, klucz tajny i webhook dla każdego trybu
Powiązane tematy
- Jeśli trzeba zrozumieć, jak działa okno ustawień sklepu — Ustawienia sklepu.
- Jeśli klienci z krajów bałtyckich są przyzwyczajeni do Paysera — Jak przyjmować płatności Paysera w sklepie.
- Jeśli trzeba wystawić fakturę i otrzymać płatność przez link — Płatność przez link.
- Jeśli trzeba obsłużyć opłacone zamówienie w Elbuz — Zamówienie klienta.
