Ten przewodnik obejmuje tworzenie konta Stripe, weryfikację adresu e-mail oraz odnajdywanie klucza API i sekretu webhooka, których użyjesz podczas dodawania konta sprzedawcy Stripe w Perno Orchestration.
Do czego służy konto Stripe?
Konto Stripe jest potrzebne, zanim będzie można połączyć Stripe jako bramkę konta sprzedawcy w Perno Orchestration - to właśnie w Stripe generowane są klucz API i sekret webhooka używane w tym połączeniu. Nowe konta zaczynają w piaskownicy (sandbox), środowisku testowym, w którym możesz zapoznać się z panelem i wygenerować testowe klucze API bez przemieszczania jakichkolwiek prawdziwych pieniędzy; na konto na żywo przełączasz się dopiero, gdy jesteś gotowy do uruchomienia produkcyjnego.
Tworzenie konta Stripe
- Przejdź na stripe.com i kliknij Dashboard w prawym górnym rogu.
- Uzupełnij Email, Imię i nazwisko oraz Hasło, wybierz swój Kraj, a następnie kliknij Create account.
Weryfikacja adresu e-mail
Stripe wysyła link weryfikacyjny na adres, którym się zarejestrowano. Otwarcie go potwierdza, że adres należy do Ciebie i kończy proces zakładania konta:
Konfigurowanie profilu firmy
- Podaj Nazwę firmy i Lokalizację firmy, a następnie kliknij Continue.
- Opcjonalnie dodaj swoją Stronę internetową oraz krótki opis działalności firmy. Kliknij Continue lub Skip, jeśli wolisz uzupełnić to później.
Wybór sposobu konfiguracji Stripe
Stripe oferuje dwa sposoby na rozpoczęcie pracy: ręczną konfigurację w panelu lub rozpoczęcie od narzędzia AI do kodowania. Wybierz Set up in the Dashboard i kliknij Continue:
Wejście do piaskownicy
Twoje nowe konto otwiera się w piaskownicy (sandbox) - bezpiecznym środowisku testowym, w którym nie są przemieszczane żadne prawdziwe pieniądze. Po zapoznaniu się z piaskownicą i ukończeniu konfiguracji możesz przełączyć się na konto na żywo, gdy będziesz gotowy do przyjmowania rzeczywistych płatności. Kliknij Go to sandbox, aby kontynuować:
Znajdowanie kluczy API
Stripe automatycznie generuje dla Twojego konta klucz publikowalny (publishable key) i klucz tajny (secret key). Możesz do nich dotrzeć na dwa sposoby:
- Ze strony Home - panel kluczy API wyświetlany po pierwszym zalogowaniu prowadzi bezpośrednio do nich.
- Albo kliknij ikonę Settings (koło zębate) w górnym pasku nawigacyjnym, a następnie wybierz Developers w sekcji Personal settings.
- Na stronie Developers kliknij Manage API keys obok wiersza API keys.
Przeglądanie kluczy API
Strona z kluczami API wyświetla dwie sekcje: Restricted keys (klucze z ograniczeniami), które tworzysz samodzielnie z określonymi limitami dostępu, oraz Standard keys (klucze standardowe), które Stripe generuje automatycznie i które mają pełny dostęp do API:
Przewiń w dół, aby zobaczyć oba klucze standardowe w pełnej postaci - Publishable key i Secret key:
Traktuj Secret key jak hasło - każdy, kto go zna, może działać w imieniu Twojego konta, więc nie udostępniaj go ani nie umieszczaj w swoim kodzie. Podczas dodawania konta sprzedawcy Stripe w Perno Orchestration to właśnie ten Secret key podajesz jako Dane API nr 1.
Znajdowanie sekretu webhooka
Sekret webhooka używany jako Dane API nr 2 nie znajduje się na stronie z kluczami API - jest generowany osobno, dla każdego miejsca docelowego zdarzeń, w Workbench.
- Otwórz Workbench i przejdź do zakładki Webhooks, a następnie kliknij + Add destination. Możesz też skorzystać z paska Search w górnej nawigacji, wpisać webhooks i wybrać Create a webhook w sekcji Workbench.
Wybór zdarzeń
- Wybierz Event destination scope (zakres miejsca docelowego zdarzeń): Your account dla zdarzeń z zasobów na Twoim własnym koncie lub Connected accounts dla zdarzeń z zasobów wewnątrz kont połączonych z Twoim. Dla konfiguracji jednego konta, takiej jak konto sprzedawcy Perno, wybierz Your account.
- Wybierz API version, z której ma korzystać miejsce docelowe, a następnie wskaż, jakich Events chcesz nasłuchiwać - zaznacz Select all, aby otrzymywać każde zdarzenie, lub wyszukaj konkretne. Stripe ostrzega, że wybranie dużej liczby zdarzeń może wpłynąć na wydajność; w przypadku analityki, a nie wyzwalaczy integracji, sugeruje skorzystanie zamiast tego z Data Pipeline. Kliknij Continue.
Wybór typu miejsca docelowego
Stripe może wysyłać zdarzenia do punktu końcowego webhooka, Amazon EventBridge lub Azure Event Grid. Wybierz Webhook endpoint i kliknij Continue:
Konfigurowanie miejsca docelowego
- Podaj Destination name (nazwę miejsca docelowego), Endpoint URL (adres URL punktu końcowego), na który mają być wysyłane zdarzenia, oraz opcjonalny Description (opis). Wybierz Snapshot payload, Thin payload lub oba - Stripe tworzy osobne miejsce docelowe, każde z własnym sekretem webhooka, dla każdego wybranego formatu ładunku. Kliknij Continue.
- Na ekranie Review and finish wyświetlana jest lista każdego skonfigurowanego miejsca docelowego wraz z jego ustawieniami.
Kopiowanie sekretu podpisującego
Po utworzeniu miejsca docelowego jego Signing secret (sekret podpisujący) - czyli sekret webhooka - jest wyświetlany w pełnej postaci, jedno miejsce docelowe na raz. Skopiuj go od razu: ponowne wyświetlenie później pokazuje jedynie zamaskowaną wartość. Kliknij Done, gdy już go skopiujesz:
Jeśli będziesz go potrzebować ponownie później, otwórz Workbench > Webhooks, wybierz miejsce docelowe i znajdź Signing secret w zakładce Overview. Domyślnie jest zamaskowany - kliknij ikonę oka, aby go odsłonić, lub ikonę odświeżania, aby wygenerować nowy sekret, co unieważnia poprzedni:
Podczas dodawania konta sprzedawcy Stripe w Perno Orchestration to właśnie ten sekret webhooka podajesz jako Dane API nr 2.