Prosty sposób: zaloguj się za pomocą Stripe
Żadnych kluczy do szukania, nic do wklejenia. Logujesz się do Stripe, zatwierdzasz Coin Moebius i wracasz za około minutę. Coin Moebius przechowuje tylko Twój identyfikator konta Stripe, nigdy klucze, a Stripe informuje nas o wszelkich zmianach dotyczących Twojego konta.
- Otwórz Dostawców i kliknij Connect a provider
W panelu Coin Moebius wybierz Dostawcy w menu po lewej stronie, a następnie kliknij Connect a provider w prawym górnym rogu.
Coin Moebius → Dostawcy → Connect a provider - Wybierz Stripe
Wpisz Stripe w polu wyszukiwania lub przewiń w dół i kliknij.
Connect a provider → Stripe - Nazwij go, dodaj dwie strony i zapisz
Nadaj połączeniu nazwę. Wprowadź adres URL sukcesu (stronę, którą kupujący zobaczy po dokonaniu płatności) i adres URL anulowania (stronę, którą zobaczy, jeśli się wycofa). Pozostań na pierwszej karcie, a następnie kliknij Save and connect with Stripe.
Pseudonim, adres URL sukcesu, adres URL anulowania → Save and connect with Stripe Obydwa adresy muszą zaczynać się od https://. To jedyne rzeczy, które wpisujesz na tym ekranie.
- Zatwierdź Stripe
Stripe otwiera się. Zaloguj się na swoje konto Stripe lub utwórz je od razu, jeśli jeszcze go nie masz, a następnie zatwierdź Coin Moebius. Stripe pokazuje, z którego konta będziesz korzystać, więc możesz to sprawdzić, zanim powiesz „tak”.
Stripe → zaloguj się lub utwórz konto → zatwierdź Coin Moebius - Wróciłeś i masz połączenie
Stripe odsyła Cię bezpośrednio do Coin Moebius. Zielony czek oznacza, że płatności kartą są gotowe, a karta Stripe znajduje się teraz na stronie Dostawców oznaczona jako Zweryfikowana i aktywna.
Powrót do Coin Moebius: Konto Stripe połączone Dostawcy → Twoja karta Stripe: zweryfikowana, aktywna Zamiast zielonego pola wyboru wyświetlił się komunikat „Wymagane działanie”? Stripe nie zakończył czyszczenia Twojego konta z tytułu płatności kartą. Skończ o co prosi Stripe, wróć i kliknij Verify na karcie Stripe.
Drugi sposób: wklej własne klucze
Wszystko od tego miejsca jest ścieżką ręczną. Konfigurujesz webhooka w panelu Stripe, zbierasz tam trzy wartości i wklejasz je do Coin Moebius. Zaplanuj około dziesięciu minut. Jeśli zarejestrowałeś się powyżej, już skończyłeś i możesz to wszystko pominąć.
Czego potrzebujesz
| Pole | Do czego służy |
|---|---|
| Publishable key (pk_…) | Klucz publiczny, który otwiera Checkout w przeglądarce. Nie jest tajny. |
| Secret key (sk_…) | Pozwala nam utworzyć sesję Checkout, by obciążenie przeszło przez Twoje konto. Tajny. |
| Webhook signing secret (whsec_…) | Potwierdza, że webhook naprawdę pochodzi od Stripe. Tajny. |
| Success URL / Cancel URL | Gdzie trafia kupujący po zapłacie lub rezygnacji. |
Potrzebuje ich tylko ścieżka kluczowa. Jeśli zarejestrowałeś się za pomocą Stripe powyżej, nie ma nic do zebrania. Stripe przechowuje osobne klucze dla trybu testowego i na żywo (pk_test_ / sk_test_ w porównaniu z pk_live_ / sk_live_), każdy z własnym sekretem podpisywania webhooka. Coin Moebius znajduje się zarówno w zakładkach Na żywo, jak i Testuj, dzięki czemu możesz zweryfikować klucze testowe i dodać klucze aktywne później bez ponownego wpisywania wszystkiego.
Dlaczego prosimy o każde pole
Publishable key
Identyfikuje Twoje konto, gdy checkout otwiera się w przeglądarce kupującego. Publiczny z założenia.
Secret key
Prywatna połowa, która autoryzuje utworzenie obciążenia, by płatność przeszła przez Twoje konto.
Webhook signing secret
Dowodzi, że przychodzący webhook naprawdę pochodzi od Stripe, by nikt nie mógł sfałszować zdarzenia "opłacono". To wartość odrębna od secret key.
Success URL i Cancel URL
Zwykłe ustawienia: gdzie trafia kupujący po zapłacie lub rezygnacji. Nie są tajne.
Konfiguracja
- Użyj trybu testowego (za darmo)
Konto Stripe jest darmowe, a tryb testowy działa przed aktywacją. Zaloguj się na dashboard.stripe.com i włącz tryb testowy (Test mode, górny róg). Skonfiguruj najpierw test, potem powtórz w live.
- Skopiuj swoje klucze
Przejdź do Developers → API keys i skopiuj Publishable key oraz Secret key.
Stripe → Developers → API keys - Dodaj webhook
- Developers → Webhooks → Add endpoint.
- Ustaw adres URL endpointu na adres webhooka Twojego projektu (poniżej).
- Wybierz zdarzenia. Dla płatności jednorazowych: checkout.session.completed, charge.refunded, charge.dispute.created. Jeśli sprzedajesz subskrypcje, dodatkowo: customer.subscription.created, customer.subscription.updated, customer.subscription.deleted, invoice.payment_succeeded, invoice.payment_failed. Dodatkowe zdarzenia są nieszkodliwe, ignorujemy to, czego nie używamy.
- Skopiuj Signing secret endpointu (whsec_…). Test i live mają każdy własny.
https://api.coinmoebius.com/webhook/stripe/<your project id>Stripe → Developers → Webhooks → Add endpoint - Testuj
Karty testowe działają tylko w trybie testowym i nigdy nie obciążają prawdziwej karty. Użyj dowolnej przyszłej daty ważności, dowolnego CVC, dowolnego kodu pocztowego.
Wynik Karta Powodzenie 4242 4242 4242 4242 Wymaga uwierzytelnienia 4000 0025 0000 3155 Odrzucona 4000 0000 0000 9995 - Podłącz w panelu
Add provider → Stripe. Wpisz publishable key, secret key, webhook signing secret, Success URL i Cancel URL. Użyj kluczy testowych, by zweryfikować przebieg, a potem edytuj dostawcę i podmień na klucze live.
Po podłączeniu
Dokonaj jednej płatności przed rozpoczęciem transmisji na żywo:
- Zalogowałeś się za pomocą Stripe? Twoje konto jest aktywne, więc kup produkt za jednego dolara za pomocą własnej karty, a następnie zwróć go od Stripe. Wklejone klucze testowe? Każda płatność jest płatnością testową, więc użyj karty testowej z góry.
- Utwórz produkt i umieść przycisk kupna na stronie (wystarczy lokalny plik HTML) wskazującej na Twój projekt.
- Zapłać kartą testową z powyższej listy.
- Otwórz zakładkę Transactions. Gdy status nowego wiersza osiągnie succeeded, Twoje klucze i webhook działają od początku do końca.
Jeśli korzystałeś z kluczy testowych, edytuj dostawcę, zamień swoje aktywne klucze, a będziesz otrzymywać prawdziwe płatności.
Rozwiązywanie problemów
Zacznij od Verify. W panelu kliknij Verify na karcie Stripe. Pyta Stripe o Twoje konto lub sprawdza Twoje klucze i zwraca konkretną wiadomość, jeśli coś jest nie tak.
Zalogowałem się za pomocą Stripe i otrzymałem komunikat „Konto połączone. Wymagane działanie”.
Twoje konto Stripe jest połączone, ale Stripe nie rozliczyło jeszcze płatności kartą. Otwórz Stripe, zakończ to, o co prosi (zwykle dane biznesowe lub konto bankowe), a następnie kliknij Verify na karcie Stripe w Coin Moebius.
Karta Stripe wyświetla komunikat Rozłączono.
Coin Moebius został usunięty z Twojego konta Stripe, zwykle ze strony Autoryzowane aplikacje w Stripe. Otwórz kartę, wybierz Edit i kliknij Reconnect, aby ponownie ją zatwierdzić.
Verify mówi, że format klucza jest błędny.
Klucze secret zaczynają się od sk_test_ lub sk_live_ (klucze ograniczone zaczynają się od rk_). Webhook signing secret zaczyna się od whsec_. Skopiuj właściwą wartość ponownie do właściwego pola.
Verify mówi, że Stripe odrzucił klucz.
Skopiuj secret key ponownie z Developers → API keys i upewnij się, że nie łączysz klucza testowego z sekretem webhooka live ani odwrotnie.
Płatność się kończy, ale zamówienie pozostaje pending.
Webhook nie dociera. Potwierdź, że adres URL endpointu zgadza się dokładnie, że wybrałeś checkout.session.completed i że płatność testowa trafia do Twojego endpointu w trybie testowym (test i live to osobne endpointy).
Weryfikacja podpisu się nie udaje.
Każdy endpoint Stripe ma własny signing secret. Skopiuj whsec_ z ustawień tego endpointu, a nie innego.
Potwierdź od początku do końca.
Stripe nie ma przycisku symulacji. W panelu Stripe ponownie wyślij niedawne zdarzenie do swojego endpointu albo utwórz testowy PaymentIntent, a następnie obserwuj aktualizację zamówienia.
Warto wiedzieć
Zalogowano się za pomocą Stripe. Nie ma żadnych kluczy ani tajnych elementów webhook, które można kopiować, przechowywać lub obracać. Stripe informuje Coin Moebius o zmianach na koncie. Aby wyciąć link, kliknij Disconnect na karcie Stripe lub usuń Coin Moebius z sekcji Autoryzowane aplikacje w Stripe.
Rotacja kluczy. Wkleiłeś własne klucze? W dowolnym momencie rzuć tajny klucz lub sekret webhooka, a następnie wklej nową wartość. Tajne pola pozostają puste podczas edycji, więc możesz wrzucić obrócony klucz.
Aktywacja. Klucze live działają dopiero po aktywacji Twojego konta do płatności. Klucze testowe działają natychmiast.
Pytania? Join our Discord