Jak skonfigurować zaawansowane ustawienia webhooków Stripe

Ten dokument zawiera zaawansowane opcje konfiguracji, które nie są potrzebne dla większości witryn.
_{Zobacz naszą dokumentację standardowych webhooków, aby uzyskać podstawową konfigurację.}

Webhooki pozwalają Stripe wysyłać wiadomości z powrotem do Twojej witryny WordPress. Konfiguracja webhooków jest wymagana dla niektórych funkcji WP Simple Pay, takich jak wysyłanie wiadomości e-mail, tworzenie planów ratalnych, umożliwienie klientom aktualizacji szczegółów płatności ich subskrypcji oraz korzystanie z integracji z AffiliateWP.

Dodawanie punktu końcowego webhook

Aby dodać odpowiednie punkty końcowe webhooków, w swoim panelu Stripe przejdź do Deweloperzy → Webhooki.

Kliknij Dodaj punkt końcowy, a następnie dodaj adres URL znaleziony w WP Simple Pay → Ustawienia → Stripe → Webhooki.

Teraz musisz dodać konkretne zdarzenia do nasłuchiwania, klikając przycisk +Wybierz zdarzenia. Po wykonaniu tej czynności możesz skopiować i wkleić każde z poniższych zdarzeń do pola wyszukiwania Wybierz zdarzenia do wysłania → Wyszukaj zdarzenia.

Po wyszukaniu każdego terminu kliknij pole wyboru, aby go dodać, i wyszukaj dodatkowe terminy. Nie klikaj Dodaj zdarzenia, dopóki nie zaznaczysz wszystkich poniższych zdarzeń:

• charge.failed
• charge.refunded
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated

Szczegóły dotyczące funkcjonalności każdego z tych zdarzeń znajdują się na dole tego dokumentu.

Po dodaniu zdarzeń kliknij Dodaj punkt końcowy , aby zakończyć proces. Po dodaniu punktu końcowego nowy adres URL powinien pojawić się w ustawieniach webhooków.

Konfiguracja tajnego klucza podpisu webhooka

Stripe może podpisywać zdarzenia webhook, które wysyła do Twoich punktów końcowych, w celu zwiększenia bezpieczeństwa i zdecydowanie zalecamy skonfigurowanie tego.

Aby to zrobić, pobierz sekret punktu końcowego z ustawień webhooków w Twoim panelu administracyjnym. Wybierz punkt końcowy, dla którego chcesz uzyskać sekret, a następnie kliknij przycisk Pokaż.

Następnie skopiuj sekret podpisu z panelu administracyjnego Stripe, wróć do zakładki Konfiguracja Stripe w swoim panelu administracyjnym WP i wklej go do pola tekstowego Sekret punktu końcowego dla bieżącego trybu płatności.

Twoje webhooki są teraz skonfigurowane i bezpieczne.

Obecnie WP Simple Pay wykorzystuje następujące zdarzenia:

Opisy typów zdarzeń

invoice.payment_succeeded

• Używane do zwiększania planów ratalnych i wysyłania wiadomości e-mail „Potwierdzenie płatności” i „Powiadomienie o płatności” e-maile dla subskrypcji.
• Udostępnia akcję simpay_webhook_subscription_created do dalszego przetwarzania po pomyślnym utworzeniu subskrypcji.

payment_intent.succeeded

• Wysyła wiadomości e-mail „Potwierdzenie płatności” i „Powiadomienie o płatności” e-maile dla płatności jednorazowych.
• Udostępnia akcję simpay_webhook_payment_intent_succeeded do dalszego przetwarzania po pomyślnej płatności.

charge.succeeded

• Wysyła wiadomości e-mail „Potwierdzenie płatności” i „Powiadomienie o płatności” e-maile dla płatności jednorazowych przy użyciu obciążenia ACH.
• Udostępnia akcję simpay_webhook_charge_succeeded do dalszego przetwarzania po pomyślnym obciążeniu.

invoice.upcoming

• Wysyła przypomnienie e-mailem „Nadchodząca faktura” e-mail o aktualizacji metody płatności. Dowiedz się więcej

checkout.session.completed

• Używane do usuwania wygenerowanych porzuconych rekordów Stripe Checkout.
• Udostępnia akcję simpay_webhook_checkout_session_completed do dalszego przetwarzania w razie potrzeby.

plan.updated

• Służy do zapewnienia aktualności listy Planów Subskrypcji podczas konfiguracji Opcji Subskrypcji.

charge.failed

• Udostępnia akcję simpay_webhook_charge_failed do dalszego przetwarzania po nieudanej próbie obciążenia.