↑↓ wybierzEnter otwórzEsc zamknij

    1. Elbuz

    Jak przyjmować płatności Stripe w sklepie

    7 min czytaniaZaktualizowano

    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

    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.

    1. Otwórz ekran modułu. „Ustawienia sklepu” → sekcja „Zamówienie i płatność” → karta Stripe.
    2. W bloku „Połączenie” zostaw włączony „Tryb testowy” i skopiuj „Adres webhooka”.
    3. Utwórz webhook w panelu Stripe z tym adresem i zdarzeniami z pola „Zdarzenia webhooka” (poniżej).
    4. W karcie „Klucze testowe” wpisz „Testowy klucz tajny” i „Testowy klucz podpisu webhooka”.
    5. Włącz przełącznik „Włączony” u góry ekranu i kliknij „Zapisz”.
    6. Sprawdź płatnością testową, potem przejdź na tryb produkcyjny.
    Sekcja „Zamówienie i płatność” ustawień sklepu z siatką kart modułów płatności, w tym Stripe
    1Karta Stripe
    2Znacznik stanu: potrzebne klucze
    1. Karta modułu płatności Stripe; kliknięcie otwiera ekran modułu.
    2. Czego brakuje modułowi: „potrzebne klucze”, dopóki nie wpiszesz kluczy bieżącego trybu.
    Ekran modułu Stripe z blokiem „Połączenie” i kartami stanu
    1Przełącznik „Włączony”
    2Tryb testowy
    3Adres webhooka
    4Co jeszcze do skonfigurowania
    5Tryb
    1. Po zapisaniu pokazuje Stripe klientom.
    2. Płatności testowe bez pobierania pieniędzy; używana jest para kluczy testowych.
    3. Wklej ten adres do webhooka w panelu Stripe.
    4. Czego jeszcze brakuje, żeby płatności działały.
    5. 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ł.

    1. W panelu Stripe: Workbench → Webhooks → Create an event destination.
    2. Wybierz Your account, format zdarzeń Snapshot.
    3. Zaznacz wszystkie 9 zdarzeń z pola „Zdarzenia webhooka”. Przycisk „Kopiuj wszystkie” skopiuje je razem.
    4. Typ — Webhook endpoint. W Endpoint URL wklej „Adres webhooka” z ekranu modułu i zapisz.
    5. Na stronie webhooka kliknij Reveal przy Signing secret i skopiuj whsec_… do pola klucza podpisu.
    Adres webhooka, zdarzenia webhooka i rozwinięta karta „Klucze testowe”
    1Adres webhooka
    2Zdarzenia webhooka
    3Testowy klucz tajny
    4Testowy klucz podpisu webhooka
    5Używane teraz
    1. Wklej w Endpoint URL webhooka w panelu Stripe.
    2. Zdarzenia do zaznaczenia w webhooku; „Kopiuj wszystkie” kopiuje je razem.
    3. Secret key z Developers → API keys w trybie testowym (sk_test_…).
    4. Signing secret testowego webhooka (whsec_…).
    5. 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ą

    1. Złóż zamówienie na siebie i wybierz Stripe. Przed przejściem pojawi się „Tryb testowy (Stripe): pieniądze nie są pobierane”.
    2. Na stronie Stripe zapłać kartą testową z tabeli. Data ważności — dowolna przyszła, CVC — dowolne trzy cyfry.
    3. Sprawdź zamówienie w Elbuz: status z pola „Opłacone”. Samą płatność widać w panelu Stripe w trybie testowym.
    Dane testowe Stripe
    Co wpisaćCo się stanie
    Karta 4242 4242 4242 4242Udana płatność
    Karta 4000 0000 0000 3220Płatność z potwierdzeniem 3-D Secure: w oknie kliknij Complete
    Karta 4000 0000 0000 0002Bank odmówił: klient zostaje na stronie Stripe i może spróbować inną kartę
    SEPA, IBAN DE89370400440532013000Najpierw „Czeka na bank”, potem „Opłacone”
    SEPA, IBAN DE62370400440532013001Najpierw „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:

    1. W panelu Stripe dokończ aktywację: Activate payments, dane firmy i konto do wypłat.
    2. Utwórz webhook w trybie produkcyjnym panelu.
    3. W karcie „Klucze produkcyjne” wpisz „Produkcyjny klucz tajny” i „Produkcyjny klucz podpisu webhooka”.
    4. 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łoDokąd wraca klient
    Zapłacił lub rozpoczął płatność odroczoną (SEPA)Strona udanego zamówienia
    Kliknął „Wstecz” na stronie StripeSkł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ściSkł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ściZostaje 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”.

    Blok „Statusy zamówienia” z pięcioma polami statusów
    1Opłacone
    2Czeka na bank
    3Płatność nieudana
    4Zwrócono
    5Zakwestionowana przez kupującego
    1. Stripe potwierdził płatność pełnej kwoty.
    2. SEPA i inne metody odroczone, dopóki bank potwierdza.
    3. Bank nie potwierdził płatności odroczonej.
    4. Po zwrocie pełnej kwoty.
    5. Klient zakwestionował płatność w banku; domyślnie status się nie zmienia.
    PoleKiedy jest nadawanyDomyślnie
    OpłaconeStripe potwierdził płatność pełnej kwoty zamówienia. Klient dostaje zwykły e-mail o zamówieniu„W realizacji”
    Czeka na bankSEPA i inne metody odroczone: klient zapłacił, bank potwierdza w ciągu kilku dni roboczych„Oczekujące”
    Płatność nieudanaBank nie potwierdził płatności odroczonej„Nieudane”
    ZwróconoKlientowi zwrócono całą kwotę„Zwrócono środki”
    Zakwestionowana przez kupującegoKlient 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:

    PrzyciskCo robi
    Zwróć środkiZwraca klientowi całą kwotę lub jej część. Pole kwoty jest już wypełnione pozostałą kwotą: aby zwrócić wszystko, zostaw proponowaną kwotę
    Odśwież statusPobiera 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”.

    ZwrotCo stanie się z zamówieniem
    Całej kwotyStatus z pola „Zwrócono”
    CzęściStatus 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 widziszDlaczego tak jestCo 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

    Czy ten artykuł był pomocny?

    Brakuje funkcji? Napisz do nas.

    Dodamy ją za darmo, jeśli przyda się też innym.

    Jeśli potrzebujesz jej tylko ty — umówimy się osobno.

    Spis treści

    Zaproponuj usprawnienie

    Wypróbuj Elbuz za darmo