Stripe

Oto objaśnienie ustawień płatności dla operatora Stripe.

Stripe jest operatorem międzynarodowym - przydaje się szczególnie wtedy, kiedy przyjmujesz płatności w walucie innej niż złotówki.

Dostępne opcje

Oto lista dostępnych opcji wraz z krótkim objaśnieniem.

Klucz API Stripe

Określa tajny klucz API Twojego konta Stripe (zaczynający się od sk_). Może to być również klucz ograniczony (rk_).

Sekret webhooka Stripe

Określa sekret podpisu (whsec_...) webhooka, przez który Stripe informuje Foto.Guru o statusie płatności. Dzięki niemu status zamówienia zmienia się automatycznie na „Opłacone”, kiedy klient poprawnie je opłaci.

Obie wartości znajdziesz w panelu Stripe. Poniżej pokazujemy krok po kroku, gdzie ich szukać.

Wskazówka

Stripe ma osobne klucze i osobne webhooki dla trybu testowego i produkcyjnego. Jeśli w Foto.Guru włączysz Tryb testowy, wykonaj poniższe kroki w trybie testowym Stripe (przełącznik Test mode w prawym górnym rogu panelu). Przed uruchomieniem prawdziwych płatności powtórz je w trybie produkcyjnym.

Ustawienia na koncie Stripe

Klucz API

Klucz API w panelu Stripe

  1. W lewym dolnym rogu panelu kliknij Developers.

  2. Wybierz API keys.

  3. W sekcji Standard keys skopiuj wartość Secret key (zaczyna się od sk_) i wklej ją w Foto.Guru w polu Klucz API Stripe.

Webhook - dodanie punktu odbioru zdarzeń

Lista webhooków w panelu Stripe

  1. Ponownie kliknij Developers.

  2. Wybierz Webhooks.

  3. Kliknij Add destination.

Webhook - wybór zdarzeń

Wybór zdarzeń dla webhooka

  1. Jako źródło zdarzeń zostaw zaznaczone Your account.

  2. Wersję API pozostaw domyślną.

  3. W polu wyszukiwania wpisz nazwę zdarzenia.

  4. Zaznacz znalezione zdarzenie. Powtórz kroki 3 i 4 dla każdego z trzech zdarzeń:

    • checkout.session.completed

    • checkout.session.async_payment_succeeded

    • checkout.session.async_payment_failed

    Po zaznaczeniu wszystkich, na karcie Selected events powinna być widoczna liczba 3.

  5. Kliknij Continue.

Webhook - typ punktu odbioru

Wybór typu punktu odbioru zdarzeń

  1. Wybierz Webhook endpoint.

  2. Kliknij Continue.

Webhook - adres punktu odbioru

Konfiguracja punktu odbioru zdarzeń

  1. W polu Destination name wpisz dowolną nazwę, np. FotoGuru callback.

  2. W polu Endpoint URL wklej adres webhooka, który Foto.Guru wyświetla w ustawieniach płatności po wybraniu operatora Stripe:

    https://app.foto.guru/gateways/stripe_gateway/callback

  3. Kliknij Create destination.

Webhook - sekret podpisu

Sekret podpisu utworzonego webhooka

Po utworzeniu punktu odbioru Stripe pokaże jego szczegóły. W sekcji Signing secret:

  1. Kliknij ikonę oka, aby odsłonić sekret.

  2. Kliknij ikonę kopiowania i wklej wartość (zaczyna się od whsec_) w Foto.Guru w polu Sekret webhooka Stripe.

Na koniec zapisz zmiany w Foto.Guru. Od tej chwili każda poprawnie zakończona płatność będzie automatycznie zmieniać status zamówienia na „Opłacone”.