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.

Jeśli Webhook zostanie pominięty

Webhook, który nigdy nie dotrze, nie jest już trwały. Raz na godzinę WP Simple Pay sprawdza Stripe pod kątem rekordów, które mógł pominąć, i doprowadza je do porządku: kasy, które zostały zrealizowane, gdy klient nigdy nie wrócił na Twoją stronę, płatności, które się powiodły lub zostały później anulowane, oraz zwroty lub obciążenia zwrotne zastosowane bezpośrednio z Panelu Stripe. Płatność, która wcześniej widniała jako oczekujący symbol zastępczy, rozwiązuje się sama.

Nadal powinieneś poprawnie skonfigurować webhoki, ponieważ godzinne sprawdzenie następuje po fakcie, a wszystko, co zależy od natychmiastowej odpowiedzi (e-maile, plany ratalne), wymaga zdarzenia na żywo. Ale nie musisz ręcznie szukać pojedynczego pominiętego zdarzenia. Możesz potwierdzić wynik w sekcji Formularze płatności > Transakcje — zobacz Jak korzystać ze strony Transakcje.

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**
• obciążenie.zwrot
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• payment_intent.processing
• payment_intent.succeeded
• customer.subscription.deleted
• customer.subscription.updated
• charge.dispute.created
• charge.dispute.closed

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.zaktualizowany

• 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.

charge.dispute.created

• Oznacza pasującą płatność jako sporną, gdy obciążenie zwrotne jest aktywne, dzięki czemu jest widoczna w widoku Sporne na stronie Transakcje. Wymaga WP Simple Pay Pro.
• Udostępnia akcję simpay_webhook_charge_dispute_created do dalszego przetwarzania po otwarciu obciążenia zwrotnego.

charge.dispute.closed

• Przywraca poprzedni status płatności, gdy spór zostanie zamknięty na Twoją korzyść, niezależnie od tego, czy został wygrany, zamknięty jako zapytanie, czy zapobiegnięty przez Stripe. Płatność, która została częściowo zwrócona, wraca do stanu częściowo zwróconej, a nie po prostu zakończonej sukcesem. Przegrany spór pozostaje sporny, ponieważ środki zostały faktycznie wycofane. Wymaga WP Simple Pay Pro.
• Udostępnia akcję simpay_webhook_charge_dispute_closed do dalszego przetwarzania po zamknięciu obciążenia zwrotnego.