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 das Basis-Setup.

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.

Wenn ein Webhook verpasst wird

Ein Webhook, der nie ankommt, ist nicht mehr permanent. Einmal pro Stunde prüft WP Simple Pay Stripe auf Datensätze, die es möglicherweise verpasst hat, und gleicht sie ab: Kassen, die abgeschlossen wurden, während der Kunde nie auf Ihre Website zurückkehrte, Zahlungen, die später erfolgreich waren oder storniert wurden, und Rückerstattungen oder Rückbuchungen, die direkt über das Stripe Dashboard angewendet wurden. Eine Zahlung, die früher als ausstehender Platzhalter galt, löst sich von selbst.

Sie sollten Webhooks trotzdem richtig einrichten, da die stündliche Prüfung nachträglich ausgeführt wird und alles, was eine sofortige Reaktion erfordert (E-Mails, Ratenzahlungen), das Live-Ereignis benötigt. Aber Sie müssen kein einzelnes verpasstes Ereignis von Hand suchen. Sie können das Ergebnis unter Zahlungsformulare > Transaktionen überprüfen – siehe Verwendung der Transaktionsseite.

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:

• **Aufladung fehlgeschlagen**
• Aufladung.zurückerstattet
• charge.succeeded
• checkout.session.completed
• invoice.payment_succeeded
• invoice.upcoming
• Zahlungsabsicht wird bearbeitet
• payment_intent.succeeded
• Kundenabonnement gelöscht
• Kundenabonnement aktualisiert
• charge.dispute.created
• charge.dispute.closed

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.

**Aufladung fehlgeschlagen**

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

charge.dispute.created

• Markiert die übereinstimmende Zahlung als angefochten, während eine Rückbuchung besteht, sodass sie unter der Ansicht Angefochten auf der Transaktionsseite angezeigt wird. Erfordert WP Simple Pay Pro.
• Exponiert die Aktion simpay_webhook_charge_dispute_created zur weiteren Verarbeitung, wenn eine Rückbuchung eröffnet wird.

charge.dispute.closed

• Stellt den vorherigen Status der Zahlung wieder her, wenn die Anfechtung zu Ihren Gunsten geschlossen wird, sei es gewonnen, als Anfrage geschlossen oder von Stripe verhindert. Eine teilweise erstattete Zahlung kehrt zu teilweise erstattet zurück, anstatt einfach erfolgreich zu sein. Eine verlorene Anfechtung bleibt angefochten, da die Gelder tatsächlich abgezogen wurden. Erfordert WP Simple Pay Pro.
• Exponiert die Aktion simpay_webhook_charge_dispute_closed zur weiteren Verarbeitung, wenn eine Rückbuchung geschlossen wird.