Aktionen mit Webhooks auslösen
Ein Webhook ist ein HTTP-Endpoint, der Ereignisse von Stripe empfängt.
Durch Webhooks können Sie unter anderem über folgende, echte Zahlungsereignisse außerhalb Ihres Zahlungsvorgangs benachrichtigt werden:
- Erfolgreiche Zahlungen (
payment_intent.succeeded
) - Angefochtene Zahlungen (
charge.dispute.created
) - Auf Ihrem Stripe-Konto verfügbares Guthaben (
balance.available
)
Während das Dashboard ideal für einmalige Aktionen wie die Rückerstattung einer Zahlung oder die Aktualisierung von Kundeninformationen geeignet ist, sind Webhooks wichtig für die Skalierung Ihrer Zahlungsinformationen, da sie Ihnen bei der Verarbeitung großer Mengen unternehmenskritischer Ereignisse helfen.
Erstellen Sie Ihren eigenen Webhook
Sie können auf Ihrem eigenen Server einen Webhook-Handler erstellen, der all Ihre Zahlungsabläufe offline verwaltet. Beginnen Sie, indem Sie einen Endpoint bereitstellen, der Anfragen von Stripe empfangen kann und verwenden Sie die CLI, um Ihre Integration lokal zu testen. Jede Anfrage von Stripe enthält ein Ereignis-Objekt mit einer Referenz zu dem Objekt in Stripe, das geändert wurde.
Erstellen Sie einen Webhook-Endpoint
Fügen Sie einen neuen Endpoint in Ihrer Anwendung hinzu. Sie können auf bestimmte Ereignisse reagieren, indem Sie das Feld type
des Ereignisses auswählen, das im Haupttext der Anfrage gesendet wurde. Drucken Sie zunächst die Standardausgabe, um sich zu vergewissern, dass der Webhook funktioniert.
Starten Sie nach Hinzufügen des neuen Endpoints Ihren Server.
Installieren und richten Sie die Stripe-CLI ein
Weitere Installationsoptionen finden Sie unter Mit der Stripe-CLI loslegen.
Führen Sie nach Installieren der Stripe-CLI in der Kommandozeile stripe login
aus, um einen Kopplungscode zu generieren, der eine Verknüpfung zu Ihrem Stripe-Konto herstellt. Drücken Sie auf Eingabe, um Ihren Browser zu starten und sich in Ihrem Stripe-Konto anzumelden, um den Zugriff zu genehmigen. Der erstellte API-Schlüssel ist 90 Tage lang gültig. Sie können den Schlüssel unter API-Schlüssel im Dashboard ändern oder löschen.
stripe login Your pairing code is: humour-nifty-finer-magic Press Enter to open up the browser (^C to quit)
Wenn Sie einen bestehenden API-Schlüssel nutzen möchten, verwenden Sie die Markierung --api-key
:
stripe login --api-key
Your pairing code is: humour-nifty-finer-magic Press Enter to open up the browser (^C to quit)sk_test_4eC39HqLyjWDarjtT1zdp7dc
Testen Sie Ihren Webhook lokal
Verwenden Sie die CLI, um Ereignisse an Ihren lokalen Webhook-Endpoint mithilfe des Befehls listen
weiterzuleiten.
Sofern Ihre Anwendung auf dem Port 4242 ausgeführt wird, führen Sie Folgendes aus:
stripe listen --forward-to http://localhost:4242/webhook
Verwenden Sie in einer anderen Terminal-Registerkarte den CLI-Befehl trigger
, um ein Probe-Webhook-Ereignis auszulösen.
stripe trigger payment_intent.succeeded
Sie sollten in Ihrer Registerkarte listen
folgendes Ereignis sehen:
[200 POST] OK payment_intent.succeeded
Sie sollten außerdem „PaymentIntent war erfolgreich!“ gedruckt auf der Terminal-Registerkarte, auf der Ihr Server ausgeführt wird, sehen.
Stellen Sie Ihren Webhook-Endpoint bereit
Wenn Sie bereit sind, Ihren Webhook-Endpoint für die Produktion bereitzustellen, müssen Sie vorher ein paar Dinge beachten:
Verwenden Sie Ihre Live-Modus-API-Schlüssel, nicht Ihre Test-Modus-Schlüssel.
Konfigurieren Sie Ihren Webhook-Endpoint im Stripe Dashboard oder mit der API.
Um Ihren Endpoint im Dashboard zu konfigurieren, gehen Sie zu Ihren Webhook-Einstellungen.
Klicken Sie auf „Endpoint“ hinzufügen und geben Sie die URL Ihres Endpoints, die Stripe-API-Version sowie die spezifischen Ereignisse, die Stripe senden soll, ein.
Ersetzen Sie das Webhook-Endpoint-Geheimnis in Ihrer Anwendung durch das neue Ereignis, das in der Dashboard-Ansicht Ihres Endpoints erscheint.
Das war’s! Ihre Anwendung kann jetzt Live-Ereignisse empfangen. Weitere Informationen zum Konfigurieren Ihres Webhook-Endpoints, der Webhook-Endpoint-API und Testen im Test-Modus finden Sie in unserem Entwicklungsleitfaden.