Konfigurieren Ihrer Website für den Empfang von Webhooks von Stripe

Webhooks ermöglichen es Stripe, Nachrichten an Ihre WordPress-Website zurückzusenden. Die Einrichtung 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.

WP Simple Pay versucht, Webhook-Endpunkte automatisch zu erstellen. In den meisten Fällen ist eine manuelle Konfiguration, wie unten gezeigt, nicht erforderlich.

Einen Endpunkt in Stripe hinzufügen

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.

Aktivieren Sie Ereignisse für verbundene Konten abhören nicht, da dies die Webhook-Funktionalität von WP Simple Pay beeinträchtigt.

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:

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

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 das Geheimnis Ihres Endpunkts aus den Webhook-Einstellungen Ihres Dashboards ab. Wählen Sie den hinzugefügten Endpunkt aus, für den Sie das Geheimnis abrufen möchten, und klicken Sie dann auf die Schaltfläche Anzeigen .

Kopieren Sie dann das Signiergeheimnis aus dem Stripe-Dashboard, gehen Sie zurück zu WP Simple Pay → Einstellungen → Stripe → Webhooks in Ihrem WordPress-Adminbereich und fügen Sie es dann in das Textfeld Endpoint Secret für den aktuellen Zahlungsmodus ein.

Im Testmodus wiederholen

Ein Webhook-Endpunkt muss auch im Testmodus erstellt werden. Schalten Sie den Testmodus-Schalter oben rechts im Stripe-Dashboard um und wiederholen Sie die obigen Schritte.

Ereignistypbeschreibungen

invoice.payment_succeeded

• Wird verwendet, um Ratenpläne zu erhöhen und „Zahlungsbestätigung“ und „Zahlungsbenachrichtigung“ E-Mails für Abonnements zu senden.
• Gibt die Aktion simpay_webhook_subscription_created für die weitere Verarbeitung nach einer erfolgreichen Abonnementerstellung frei.
• Gibt die Aktion simpay_webhook_invoice_payment_succeeded für die weitere Verarbeitung nach der Bearbeitung einer Rechnung frei.

<?php
add_action(
	'simpay_webhook_subscription_created',
	/**
	 * Fires when a subscription is created in Stripe.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event        $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\Subscription $subscription Stripe Subscription.
	 */
	function( $event, $subscription ) {
		// Do something.
	},
	10,
	2
);

<?php
add_action(
	'simpay_webhook_invoice_payment_succeeded',
	/**
	 * Fires when a subscription invoice payment has succeeded.
	 * Does not fire for the subscription creation (first) invoice.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event        $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\Invoice      $invoice Stripe Invoice object.
	 * @param \SimplePay\Vendor\Stripe\Subscription $subscription Stripe Subscription object.
	 */
	function( $event, $invoice, $subscription ) {
		// Do something.
	},
	10,
	3
);

Erfahren Sie, wie Sie benutzerdefinierten Code hinzufügen →

payment_intent.succeeded

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

<?php
add_action(
	'simpay_webhook_payment_intent_succeeded',
	/**
	 * Fires when a one-time payment has succeeded.
	 * 
	 * @param \SimplePay\Vendor\Stripe\Event         $event Stripe webhook event.
	 * @param \SimplePay\Vendor\Stripe\PaymentIntent $paymentintent Stripe PaymentIntent.
	 */
	function( $event, $paymentintent ) {
		// Do something.
	},
	10,
	2
);

Erfahren Sie, wie Sie benutzerdefinierten Code hinzufügen →

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.
• Gibt die Aktion simpay_webhook_checkout_session_completed für die weitere Verarbeitung bei Bedarf frei.

charge.succeeded

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

charge.failed

• Gibt die Aktion simpay_webhook_charge_failed für die weitere Verarbeitung nach einem fehlgeschlagenen Charge frei.

Häufig gestellte Fragen

Sind Webhooks erforderlich?

Webhooks sind nicht erforderlich, um Zahlungen zu verarbeiten, und wenn ein Webhook fehlschlägt, bedeutet dies nicht, dass eine Zahlung fehlgeschlagen ist. Webhooks werden jedoch verwendet, um Funktionen wie Betrugserkennung, E-Mail-Belege, Benachrichtigungen über anstehende Rechnungen und die Verwaltung von Ratenplänen zu ermöglichen.

Webhooks sind erforderlich, um die E-Mail-Verifizierung bei erkannter Betrugsaktivität zu nutzen.

Auch wenn Sie diese Funktionen derzeit nicht nutzen, wird dringend empfohlen, sicherzustellen, dass Sie den Webhook-Endpunkt korrekt konfiguriert haben, um Verwirrung zu vermeiden, falls Sie sich entscheiden, diese Funktionen in Zukunft zu aktivieren, oder wenn WP Simple Pay diese Funktionalitäten für zukünftige Funktionen benötigt.

Warum sehe ich „WP Simple Pay funktioniert möglicherweise nicht richtig.“

WP Simple Pay versucht, Sie auf eine mögliche Fehlkonfiguration oder einen Fehler des Webhook-Endpunkts hinzuweisen, um Unterbrechungen von Funktionen, die die Webhook-Funktionalität nutzen (E-Mails, Ratenpläne usw.), zu vermeiden. Wenn WP Simple Pay kein erwartetes Webhook-Ereignis verifizieren kann, sehen Sie eine Benachrichtigungsblase in den Plugin-Einstellungen und die Fehlermeldung „WP Simple Pay funktioniert möglicherweise nicht richtig.“

Wie behebe ich einen falsch konfigurierten Webhook-Endpunkt?

Um eine mögliche Fehlkonfiguration des Webhook-Endpunkts zu beheben, besuchen Sie Entwickler → Webhooks in Ihrem Stripe-Dashboard (wenn Sie sich im Testmodus befinden, zeigen Sie Ihre Testmodus-Endpunkte an).

Unter Gehostete Endpunkte sollten Sie einen Eintrag sehen, der den WP Simple Pay Webhook-Ereignisempfänger enthält: wp-json/wpsp/v1/webhook-receiver. Wenn Sie diesen Endpunkt nicht sehen, führen Sie bitte die Konfigurationsschritte aus, die zu Beginn dieses Artikels beschrieben sind.

Klicken Sie auf die WP Simple Pay-Endpunkt-URL, um die Konfiguration des Endpunkts anzuzeigen. Hier finden Sie eine Liste der Webhook-Ereignisse, die an den Endpunkt gesendet wurden.

Klicken Sie auf die Registerkarte Fehlgeschlagen, um alle fehlgeschlagenen Ereignisse aufzulisten.

Wenn Sie fehlgeschlagene Webhook-Ereignisse haben, wird durch Auswahl eines der Einträge die vom Endpunkt-URL empfangene Antwort angezeigt. Diese Antwort enthält oft Informationen darüber, warum der Endpunkt das Ereignis im Abschnitt Antwort nicht verarbeiten konnte.

Verbindung zum Remote-Host fehlgeschlagen

Stripe konnte nicht mit Ihrem Server kommunizieren. Bitte stellen Sie sicher, dass Ihr Webserver auf Anfragen reagiert und insbesondere in der Lage ist, auf alle vollständig qualifizierten Domänennamen und IP-Adressen von Stripe zu reagieren.

Keine Signaturen gefunden, die der erwarteten Signatur für die Nutzlast entsprechen

Stripe konnte die Webhook-Ereignisdaten nicht mit den in WP Simple Pay → Einstellungen → Stripe → Webhooks angegebenen Signaturgeheimnissen verifizieren. Klicken Sie beim Anzeigen Ihres Webhook-Endpunkts unter Signaturgeheimnis auf Anzeigen und aktualisieren Sie Ihre Signaturgeheimnissseinstellungen in WP Simple Pay für jeden Zahlungsmodus.

404 FEHLER <!DOCTYPE html>

Die Webhook-Endpunkt-URL ist falsch und verweist auf eine 404-Seite, die nicht gefunden wurde. Besuchen Sie WP Simple Pay → Einstellungen → Stripe → Webhooks, um den korrekten Wert Ihrer Webhook-Endpunkt-URL zu finden und den Endpunkt in Stripe zu aktualisieren.

Ich habe meine Endpunkteinstellungen überprüft, warum sehe ich immer noch einen Fehler?

WP Simple Pay reagiert bewusst übermäßig auf mögliche Fehlkonfigurationen, um sicherzustellen, dass ein echter Fehler nicht unbemerkt bleibt. Es ist jedoch immer noch möglich,  Fehlalarme bezüglich eines falsch konfigurierten Webhook-Ereignisses zu erhalten. Dies kann auftreten, wenn die Übermittlung der Ereignisdaten durch Stripe länger als üblich dauert oder in einigen Fällen von Stripe Checkout, wenn die externe Zahlungsseite verlassen wird.

Wenn Sie überprüft haben, dass keine fehlgeschlagenen Webhook-Endpunkt-Ereignisse an Ihrem Endpunkt aufgetreten sind, können Sie die Konfigurationsbenachrichtigung deaktivieren, indem Sie die folgenden Schritte ausführen.

Kann ich Webhook-Konfigurationsbenachrichtigungen deaktivieren?

Wie bereits erwähnt, wird dringend empfohlen, Ihren Webhook-Endpunkt ordnungsgemäß zu konfigurieren und aktiviert zu lassen. Wenn Sie jedoch auf eigenes Risiko nicht über potenzielle Fehlkonfigurationen oder falsch empfangene Ereignisse benachrichtigt werden möchten, können Sie die Benachrichtigung in WP Simple Pay → Einstellungen → Stripe → Webhooks dauerhaft ausblenden, indem Sie auf Nicht mehr anzeigen klicken.