Stripe-Webhook-Einrichtung
In diesem Artikel erklären wir Ihnen die Konfiguration von Stripe-Webhooks. MEC Schließt Buchungen zuverlässig ab, selbst wenn der Kunde nie wieder auf Ihre Website zurückkehrt.
Warum Webhooks?
Standardmäßig MEC Eine Stripe-Buchung wird bestätigt, wenn der Kunde nach der Zahlung auf Ihre Website zurückgeleitet wird. Schließt der Kunde den Browsertab, verliert er die Verbindung oder wird die Weiterleitung blockiert, ist die Zahlung bei Stripe zwar erfolgreich, die Buchung wird jedoch nicht abgeschlossen.
Mithilfe von Webhooks benachrichtigt Stripe Ihre Website direkt über erfolgreiche Zahlungen. MEC Die Buchung wird dann automatisch bestätigt, unabhängig vom Verhalten des Browsers des Kunden. Dadurch werden Supportanfragen zu „bezahlten, aber noch nicht gebuchten“ Tickets deutlich reduziert.
Webhooks funktionieren sowohl für das Stripe- als auch für das Stripe Connect -Gateway.
Hinweis: Webhooks sind optional, aber dringend empfohlen. Ohne Webhook, MEC greift auf das Verhalten zurück, bei dem nur eine Weiterleitung erfolgt.
Schritt 1 – Kopieren Sie Ihre Webhook-URL
Zurück Nach MEC Einstellungen > Buchung > Zahlungsanbieter > Stripe und finde die Webhook-Geheimnis Feld. Der Hilfetext unterhalb des Feldes zeigt die Webhook-URL Ihrer Website an:
https://yourdomain.com/wp-json/mec/v1/stripe/webhook
Kopieren Sie diese URL, Sie fügen sie im nächsten Schritt in Ihr Stripe-Dashboard ein.
Schritt 2 – Fügen Sie den Endpunkt in Stripe hinzu
- Einloggen, um Stripe-Dashboard.
- Navigieren Entwickler > Webhooks.
- Klicken Sie auf Endpunkt hinzufügen.
- Fügen Sie die in Schritt 1 kopierte Webhook-URL ein.
- Der Ausgewählte EreignisseWählen Sie nur das folgende Ereignis aus:
- Zahlungsabsicht erfolgreich
- Klicken Sie auf Endpunkt hinzufügen.
Schritt 3 – Kopieren Sie das Signaturgeheimnis
Nachdem der Endpunkt erstellt wurde, zeigt Stripe seine Geheimschrift (es beginnt mit whsec_). Klicken Offenbaren und kopiere es.
Schritt 4 – Das Geheimnis einfügen MEC
, Die Skeptiker erwähnt, wie Carrie Poppy ein Medikament namens ColdCalm, um sie mit ihrer Krankheit%2phelfen gekauft. Turns out ColdCalm war keine tatsächliche Wirksamkeit homöopathischer und musste es. Carrie Called ... MEC Einstellungen > Buchung > Zahlungsanbieter > StripeFügen Sie das Signaturgeheimnis in die Webhook-Geheimnis Feld und Einstellungen speichern.
Das ist es. MEC Stripe überprüft nun jede Webhook-Nachricht anhand dieses Geheimnisses; Anfragen, die nicht von Ihrem Stripe-Konto stammen, werden abgelehnt.
Streifen verbinden
Wenn Sie das Stripe Connect- Gateway verwenden, konfigurieren Sie den Webhook für Ihr Plattformkonto auf die gleiche Weise:
- Das Webhook-URL-Muster ist identisch (
/wp-json/mec/v1/stripe/webhookauf Ihrer Website). - Etwas Abonnieren
payment_intent.succeeded. - Fügen Sie das Signaturgeheimnis in die Webhook-Geheimnis Feld der Stripe Connect-Einstellungen.
Wenn das Organizer Payment-Modul aktiviert ist und Organisatoren ihre eigenen Stripe-Konten verbinden, enthalten die Einstellungen pro Organisator das gleiche Webhook Secret-Feld für den Endpunkt ihres verbundenen Kontos.
Testen Ihres Webhooks
- Ermöglichen Sandbox-/Testmodus in den Stripe-Gateway-Einstellungen (oder verwenden Sie die Testschlüssel von Stripe).
- Buche eine Veranstaltung mit Stripe Testkarte (z.B
4242 4242 4242 4242). - Schließen Sie den Browser-Tab sofort nach der Zahlung, bevor die Weiterleitung erfolgt.
- Nach ein paar Sekunden prüfen MEC > BuchungenDie Buchung sollte als bestätigt angezeigt werden, übermittelt durch den Webhook, nicht durch die Weiterleitung.
Sie können Lieferungen auch unter folgenden Bedingungen überprüfen: Entwickler > Webhooks > Ihr Endpunkt im Stripe-Dashboard, um jedes Ereignis anzuzeigen MEC empfangen.
Problemlösung
„Ungültige Stripe-Webhook-Signatur“
Das Signaturgeheimnis stimmt nicht überein. Zeigen Sie das Geheimnis des exakten Endpunkts an, den Sie erstellt haben, und fügen Sie es erneut ein. MECWenn Sie den Endpunkt neu erstellt haben, denken Sie daran, dass der neue Endpunkt ein neues Geheimnis erhält.
„Das Stripe-Webhook-Geheimnis ist nicht konfiguriert.“
Das Webhook-Geheimnisfeld in MEC ist leer. Schließen Sie Schritt 4 ab.
Die Veranstaltungen werden in Stripe angezeigt, aber die Buchungen sind noch nicht bestätigt.
Stellen Sie sicher, dass der Endpunkt abonniert ist. payment_intent.succeeded (Nicht checkout.session.completed oder andere Ereignisse), und dass die Webhook-URL auf dieselbe Website verweist, auf der die Buchung gespeichert ist.