Konfigurieren eines erweiterten Stripe-Webhook-Setups

Dieses Dokument enthält erweiterte Setup-Optionen, die für die meisten Websites nicht erforderlich sind.
_{Siehe unsere Standard-Webhook-Dokumentation für die Basiseinrichtung.}

Webhooks ermöglichen es Stripe, Nachrichten zurück an Ihre WordPress-Website zu senden. Das Einrichten von Webhooks ist für einige Funktionen von WP Simple Pay erforderlich, wie z. B. das Senden von E-Mails, das Erstellen von Ratenplänen, das Ermöglichen für Kunden, ihre Abonnement-Zahlungsdetails zu aktualisieren, und die Verwendung der Integration mit AffiliateWP.

Hinzufügen des Webhook-Endpunkts

Um die entsprechenden Webhook-Endpunkte hinzuzufügen, navigieren Sie in Ihrem Stripe Dashboard zu Entwickler → Webhooks.

Klicken Sie auf Endpunkt hinzufügen, und fügen Sie dann die URL ein, die Sie unter WP Simple Pay → Einstellungen → Stripe → Webhooks finden.

Sie müssen nun die spezifischen Ereignisse hinzufügen, auf die Sie hören möchten, indem Sie auf die Schaltfläche +Ereignisse auswählen klicken. Danach können Sie jeden der unten aufgeführten Ereignisse kopieren und in das Suchfeld Ereignisse auswählen → Ereignisse suchen einfügen.

Klicken Sie nach der Suche nach jedem Begriff auf das Kontrollkästchen, um ihn hinzuzufügen, und suchen Sie nach weiteren Begriffen. Klicken Sie erst auf Ereignisse hinzufügen, wenn Sie alle unten aufgeführten Ereignisse ausgewählt haben:

• 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

Details zur Funktionalität jedes dieser Ereignisse finden Sie am Ende dieses Dokuments.

Wenn Sie mit dem Hinzufügen von Ereignissen fertig sind, klicken Sie auf Endpunkt hinzufügen, um den Vorgang abzuschließen. Nachdem Sie den Endpunkt hinzugefügt haben, sollte die neue URL in den Webhook-Einstellungen aufgeführt sein.

Konfigurieren des Webhook-Signaturgeheimnisses

Stripe kann die von ihm an Ihre Endpunkte gesendeten Webhook-Ereignisse zur zusätzlichen Sicherheit signieren, und wir empfehlen dringend, dies einzurichten.

Rufen Sie dazu Ihr Endpunkt-Geheimnis aus den Webhook-Einstellungen Ihres Dashboards ab. Wählen Sie einen Endpunkt aus, für den Sie das Geheimnis abrufen möchten, und klicken Sie dann auf die Schaltfläche Anzeigen.

Kopieren Sie dann das Signaturgeheimnis aus dem Stripe-Dashboard, gehen Sie zurück zum Tab Stripe-Setup in Ihrem WP-Admin und fügen Sie es in das Textfeld Endpunkt-Geheimnis für den aktuellen Zahlungsmodus ein.

Ihre Webhooks sind jetzt eingerichtet und sicher.

Derzeit verwendet WP Simple Pay die folgenden Ereignisse:

Ereignistypbeschreibungen

invoice.payment_succeeded

• Wird verwendet, um Ratenpläne zu erhöhen und „Zahlungsbestätigung“ und „Zahlungsbenachrichtigung“ E-Mails für Abonnements zu senden.
• Stellt die Aktion simpay_webhook_subscription_created für die weitere Verarbeitung nach einem erfolgreichen Abonnement bereit.

payment_intent.succeeded

• Sendet die „Zahlungsbestätigung“ und „Zahlungsbenachrichtigung“ E-Mails für einmalige Zahlungen.
• Stellt die Aktion simpay_webhook_payment_intent_succeeded für die weitere Verarbeitung nach erfolgreicher Zahlung bereit.

charge.succeeded

• Sendet die „Zahlungsbestätigung“ und „Zahlungsbenachrichtigung“ E-Mails für einmalige Zahlungen mit ACH-Lastschrift.
• Stellt die Aktion simpay_webhook_charge_succeeded für die weitere Verarbeitung nach erfolgreicher Zahlung bereit.

invoice.upcoming

• Sendet die „Anstehende Rechnung“-E-Mail-Erinnerung zur Aktualisierung einer Zahlungsmethode. Mehr erfahren

checkout.session.completed

• Wird verwendet, um generierte, verlassene Stripe Checkout-Datensätze zu entfernen.
• Stellt die Aktion simpay_webhook_checkout_session_completed für die weitere Verarbeitung bei Bedarf bereit.

plan.updated

• Wird verwendet, um sicherzustellen, dass die Liste der Abonnementpläne bei der Konfiguration von Abonnementoptionen auf dem neuesten Stand ist.

charge.failed

• Stellt die Aktion simpay_webhook_charge_failed für die weitere Verarbeitung nach einem fehlgeschlagenen Charge bereit.