Try Demo Starten Sie Ihr Geschäft
Booknetic
Buch Booknetic kaufen

Stripe-Webhook einrichten

Richten Sie den Stripe-Webhook für Booknetic SaaS ein, damit Verlängerungen und Kündigungen korrekt an Ihre Plattform gemeldet werden.

Version:
Kategorien

Warum Sie einen Stripe-Webhook benötigen

Stripe Checkout bestätigt die erste Zahlung, wenn ein Mandant einen Tarif abschließt. Aber die Abrechnung des Abonnements stoppt nicht nach der ersten Zahlung.

Ein Stripe-Webhook ermöglicht Stripe, Ihre Booknetic SaaS Seite zu benachrichtigen, wenn später wichtige Abonnementereignisse stattfinden, wie zum Beispiel:

  • eine Abonnementverlängerung erfolgreich bezahlt wird
  • Ein Abonnement wird in Stripe gekündigt

Ohne funktionierenden Webhook hat Stripe möglicherweise den korrekten Abonnementstatus, aber Booknetic SaaS aktualisiert möglicherweise nicht in Echtzeit. Zum Beispiel kann ein Mandant in Stripe eine Verlängerung zahlen, aber die Abo-Periode in Booknetic SaaS kann erst verlängert werden, wenn der Webhook korrekt konfiguriert ist.

Kurz gesagt: Stripe ist der Ort, an dem die Abonnementzahlung stattfindet; Der Webhook ist der Weg, wie Booknetic SaaS vom Ergebnis erfährt.

Bevor Sie beginnen

Stellen Sie sicher, dass Sie bereits Folgendes haben:

  • Stripe in Booknetic SaaS aktiviert
  • Ihre Stripe Publishable key und Secret key in Booknetic SaaS Einstellungen hinzugefügt
  • Zugang zu Ihrem Stripe Dashboard
  • Ihre Live-Website-Domain mit HTTPS

Ihre Stripe-API-Version sollte mit Booknetic SaaS kompatibel sein. Die aktuelle Booknetic SaaS Stripe-Integration setzt die Stripe API-Version auf:

2025-07-30.basil

Wenn Sie eine sehr alte Stripe Konto-/API-Konfiguration verwenden und Webhook-Events eintreffen, aber die Abonnementverlängerungen in Booknetic SaaS immer noch nicht aktualisiert werden, kontaktieren Sie den Support zur Prüfung.

Kopieren Sie Ihre Booknetic SaaS Webhook-URL

Ihre Webhook-URL verwendet Ihre eigene Website-Domain sowie diese Booknetic SaaS Webhook-Aktion:

https://your-domain.com/?booknetic_saas_action=stripe_webhook

Ersetzen Sie https://your-domain.com durch Ihre echte SaaS-Plattform-Domäne.

Zum Beispiel:

https://example.com/?booknetic_saas_action=stripe_webhook

Wichtig: Nutzen Sie ?booknetic_saas_action=stripe_webhook. Verwenden Sie keine älteren oder anders aussehenden Webhook-URLs wie ?bkntcsaas_stripe_webhook=1.

Fügen Sie den Webhook-Endpunkt in Stripe hinzu

Für alle folgenden Schritte im Stripe Dashboard siehe die offizielle Dokumentation von Stripe für aktuelle UI-Screenshots: https://docs.stripe.com/webhooks.

In Ihrem Stripe Dashboard:

  1. Öffnen Sie Developers.
  2. Gehen Sie zu Webhooks.
  3. Klicken Sie auf Add endpoint oder Create an event destination. Stripe kann je nach Dashboard-Version beide Formulierungen anzeigen.
  4. Wählen Sie Ihr eigenes Stripe Konto als Ereignisquelle. Wählen Sie keine verbundenen Konten aus, es sei denn, Sie konfigurieren absichtlich eine Stripe Connect Anwendung.
  5. Fügen Sie Ihre Booknetic SaaS Webhook-URL in das Feld für die Endpunkt-URL ein:
https://your-domain.com/?booknetic_saas_action=stripe_webhook
  1. Fügen Sie eine klare Beschreibung hinzu, zum Beispiel:
Booknetic SaaS billing webhook
  1. Wählen Sie die im nächsten Abschnitt aufgeführten Ereignisse aus.
  2. Speichern Sie den Endpunkt.

Wählen Sie die erforderlichen Stripe-Ereignisse aus

Booknetic SaaS hört nach diesen Stripe-Webhook-Events:

Stripe Veranstaltung

Was wird in Booknetic SaaS aktualisiert

invoice.paid

Bestätigt bezahlte Verlängerungen und verlängert die Laufzeit des Mandantenabonnements

customer.subscription.deleted

Markiert das Abonnement als gekündigt/abgemeldet in Booknetic SaaS

Fügen Sie beide Ereignisse dem Endpunkt hinzu:

invoice.paid
customer.subscription.deleted

Andere Stripe Events sind für die aktuelle Booknetic SaaS Abonnement-Synchronisation nicht erforderlich.

Kopieren Sie das Webhook-Signing-Secret aus Stripe

Nachdem Sie den Endpunkt erstellt haben, öffne ihn in Stripe und enthülle das Signing secret.

Es beginnt üblicherweise mit:

whsec_

Kopieren Sie diesen Wert. Im nächsten Schritt fügen Sie ihn in Booknetic SaaS ein.

Halten Sie dieses Geheimnis privat. Senden Sie es nicht in öffentlichen Chats, Screenshots oder E-Mails.

Füge das Webhook-Geheimnis in Booknetic SaaS

In Ihrem WordPress Verwaltungsbereich:

  1. Öffnen Sie Booknetic SaaS.
  2. Gehen Sie zu Settings.
  3. Öffnen Sie den Bereich Payment Gateways oder Stripe.
  4. Finde das Webhook secret-Feld.
  5. Fügen Sie das whsec_... Unterschriftsgeheimnis von Stripe ein.
  6. Speichern Sie die Einstellungen.

Booknetic SaaS nutzt dieses Signing Secret, um zu überprüfen, ob Webhook-Anfragen wirklich von Stripe stammen. Wenn das Geheimnis fehlt oder falsch ist, wird die Webhook-Anfrage abgelehnt.

Teste den Webhook

Nachdem Sie das Endpunkt- und Webhook-Geheimnis gespeichert haben, testen Sie die Einrichtung von Stripe aus.

Im Stripe:

  1. Öffnen Sie Developers → Webhooks.
  2. Öffnen Sie den Booknetic SaaS Webhook-Endpunkt, den Sie erstellt haben.
  3. Nutzen Sie die Test-/Senden-Option von Stripe für den Endpunkt.
  4. Senden Sie ein Testereignis für eines der abonnierten Events, wie zum Beispiel invoice.paid.
  5. Überprüfen Sie das Lieferergebnis.

Eine erfolgreiche Lieferung sollte eine HTTP 200-Antwort zurückgeben.

Ein Stripe-Testereignis ist nützlich, um zu überprüfen, ob Stripe Ihre Seite erreichen können und das Signiergeheimnis akzeptiert wird. Um die vollständige Abonnementsynchronisation zu bestätigen, führen Sie außerdem einen echten Test-Abonnement-Flow im Testmodus Stripe und prüfen Sie, ob das Mandantenabonnement in Booknetic SaaS aktualisiert wird.

Wie man bestätigt, dass es funktioniert

Nach der Einrichtung können Sie den Webhook an zwei Stellen überprüfen:

  1. Stripe Dashboard → Webhooks
  • Öffnen Sie den Endpunkt.
    • Überprüfen Sie die letzten Lieferungen.
    • Erfolgreiche Zustellungen sollten eine 2xx-Antwort zeigen, meist 200.
  1. Booknetic SaaS Mandantenabrechnungs-/Abonnementzustand
  • Schließen Sie eine Test-Abonnementzahlung ab.
    • Bestätigen Sie, dass das Mandantenabonnement aktiv wird.
    • Kündige das Testabonnement in Stripe.
    • Bestätigen Sie, dass Booknetic SaaS den Abonnementstatus aktualisiert nach der Auslieferung des Webhooks aktualisiert.

Fehlerbehebung

Stripe zeigt 400 statt 200 an

Eine 400-Antwort bedeutet normalerweise, dass Booknetic SaaS die Webhook-Anfrage nicht verifizieren konnte.

Die häufigsten Ursachen:

  • Das Webhook-Geheimnis in Booknetic SaaS leer ist
  • Das falsche whsec_... Geheimnis wurde eingeklebt
  • Das Geheimnis gehört zu einem anderen Stripe-Webhook-Endpunkt
  • Der Endpunkt wurde in Stripe neu erstellt, aber das neue Geheimnis wurde nicht in Booknetic SaaS

Behebung:

  1. Öffnen Sie den Webhook-Endpunkt in Stripe.
  2. Das aktuelle Unterschriftsgeheimnis enthüllen/kopieren.
  3. Fügen Sie es erneut in Booknetic SaaS → Settings → Stripe → Webhook secret ein.
  4. Einstellungen speichern.
  5. Senden Sie ein weiteres Testereignis von Stripe.

Ein Abonnement wurde im Stripe gekündigt, aber es ist weiterhin aktiv in Booknetic SaaS

Das bedeutet in der Regel, dass Booknetic SaaS das customer.subscription.deleted Webhook-Event nicht erhalten oder akzeptiert hat.

Prüfen:

  • die URL des Webhook-Endpunkts korrekt ist
  • der Endpunkt bei customer.subscription.deleted abonniert ist
  • aktuelle Stripe Lieferungen zeigen HTTP 200
  • das Webhook-Geheimnis in Booknetic SaaS mit dem aktuellen Signierungsgeheimnis des Endpunkts übereinstimmt

Eine Verlängerung wurde in Stripe bezahlt, aber das Ablaufdatum des Mandanten wurde nicht aktualisiert

Verlängerungen werden über das invoice.paid Webhook-Event aktualisiert.

Prüfen:

  • der Endpunkt bei invoice.paid abonniert ist
  • Stripe eine erfolgreiche Lieferung für das Rechnungsereignis zeigt
  • die Lieferantwort beträgt 200
  • Das Webhook-Geheimnis korrekt ist

Wenn Stripe zeigt, dass das Ereignis erfolgreich geliefert wurde, Booknetic SaaS aber trotzdem nicht aktualisiert wurde, kontaktieren Sie den Support mit der Stripe-Ereignis-ID und dem betroffenen Mandanten.

Ich habe den Webhook-Endpunkt in Stripe geändert und jetzt funktioniert er nicht mehr

Wenn Sie einen neuen Endpunkt erstellen, generiert Stripe ein neues Signing-Secret. Kopieren Sie den Wert der neuen whsec_... in Booknetic SaaS und speichern Sie die Einstellungen erneut.

Mein Mandant fragt: "Wo kann ich meine Karte aktualisieren?"

Booknetic SaaS enthält derzeit nicht einen Stripe Customer Portal-Button, mit dem Mandanten ihre Karte selbst aktualisieren können.

Empfohlene Optionen:

  • Den Mandant bitten, das aktuelle Abonnement zu kündigen und denselben Tarif erneut abzuschließen. Die neue Kasse ermöglicht es ihnen, eine neue Karte einzutragen.
  • Wenn der Mandant Hilfe benötigt, ohne zu kündigen oder neu zu abonnieren, muss der Plattforminhaber vom Stripe Dashboard aus helfen oder den Support für manuelle Unterstützung kontaktieren.

Sagen Sie Mandanten nicht, dass sie ihre Karte über einen Booknetic SaaS Stripe Customer Portal Link aktualisieren können, denn dieses Selbstbedienungsportal ist derzeit nicht mit Booknetic SaaS verbunden.

Wo findet man Stripe Dashboard Screenshots

Diese Seite bettet Stripe Dashboard Screenshots bewusst nicht ein. Stripe aktualisiert regelmäßig seine Dashboard-Benutzeroberfläche, und veraltete Screenshots sorgen für mehr Verwirrung, als sie verhindern.

Für aktuelle, offizielle Screenshots der Webhooks-Endpunkt-Einrichtungsbildschirme siehe Stripe-eigene Dokumentation: https://docs.stripe.com/webhooks.