EreigniszieleBeta
Senden Sie Ereignisse von Stripe an Webhook-Endpoints und Cloud-Dienste.
Richten Sie ein Ereignisziel ein, um Ereignisse von Stripe für mehrere Zieltypen zu empfangen, einschließlich Webhook-Endpoints und Amazon Eventbridge.
Anwendungsszenarien![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn Sie Stripe-Integrationen erstellen, möchten Sie möglicherweise, dass Ihre Anwendungen Ereignisse in Echtzeit von Ihren Stripe-Konten empfangen, sodass Ihre Backend-Systeme entsprechend Aktionen ausführen und darauf reagieren können.
Mit einem Ereignisziel überträgt Stripe Echtzeit-Ereignisdaten von Ihrem Konto, sodass Sie Back-End-Aktionen ausführen können, zum Beispiel:
- Nutzer/innen benachrichtigen, wenn eine Kundin/ein Kunde eine Zahlung bestätigt
- Interne Anspruchsprüfung einleiten, wenn eine Kundin/ein Kunde eine Zahlung angefochten hat
- Nutzer/in Zugriff gewähren, wenn sie/er erfolgreich wiederkehrende Abonnementzahlungen leistet
Unterstützte Zieltypen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Ereignisse mit Amazon EventBridge an ein AWS-Konto senden oder über Webhook-Endpoints an einen HTTPS-Endpunkt übermitteln.
Ereignis-Übersicht![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe generiert Ereignisdaten, um Sie über die Aktivitäten in Ihrem Konto auf dem Laufenden zu halten.
Wenn ein Ereignis eintritt, generiert Stripe ein neues Ereignisobjekt. Nachdem Ihr Ziel das Ereignis empfangen hat, kann Ihre App Back-End-Aktionen ausführen (zum Beispiel indem die APIs Ihres Versanddienstleisters aufgerufen werden, um eine Sendung zu planen, nachdem Sie das Ereignis payment_
erhalten haben).
Das Ereignis, das wir an Ihr Ereignisziel senden, bietet eine Momentaufnahme des Objekts, das sich geändert hat. Es kann die Eigenschaft previous_
enthalten, das ggf. die Änderung angibt.
Sehen Sie sich die vollständige Liste der Ereignistypen an, die wir an Ihr Ereignisziel schicken.
Eine einzelne API-Anfrage kann zur Erstellung mehrerer Ereignisse führen. Wenn Sie beispielsweise ein neues Abonnement für einen Kunden/eine Kundin erstellen, kann dies zu den Ereignissen customer.
und payment_
führen. Wählen Sie die Ereignisse aus, die Sie für jedes Ereignisziel abonnieren möchten.
Beispiel für eine Ereignisnutzlast![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Die folgende Nutzlast ist ein Beispielereignis für invoice.
, das beim Erstellen eines neuen Abonnements auftritt.
{ "object": { "id": "in_1KnN0G589O8KAxCGfVSpD0Pj", "object": "invoice", "account_country": "US",
Berechtigungen für Ereignisse![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Weisen Sie Ihrem Nutzerkonto eine Admin- oder Entwicklerrolle zu, um ein Ereignis im Dashboard anzuzeigen. Um ein Ereignis mit der API abzurufen, verwenden Sie entweder einen API-Geheimschlüssel, mit dem Sie standardmäßig alle Ereignistypen anzeigen können, oder einen eingeschränkten API-Schlüssel mit aktiviertem Read
-Zugriff für die Ressource des jeweiligen Ereignistyps. Gewähren Sie zum Beispiel Read
-Zugriff auf payment_
-Ressourcen in Ihrem eingeschränkten API-Schlüssel, um die payment_
programmgesteuert abzurufen.
Zugriff auf Ereignisse![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Über die Registerkarte Ereignisse in Workbench können Sie auf Ereignisse zugreifen, die in den letzten 13 Monaten erstellt wurden. Im Abschnitt Ereignisübermittlungen können Sie jedoch nur Übermittlungsversuche manuell erneut senden oder anzeigen, die höchstens 15 Tage alt sind. Für Ereignisse, die älter als 30 Tage sind, können Sie auf eine Übersichtsansicht zugreifen, die nur gekürzte Felder der ursprünglichen Ereignisdaten enthält.
Auf Ereignisse innerhalb der letzten 30 Tage können Sie über die Retrieve Event API und die List Event API zugreifen.
Ein Ereignisziel deaktivieren![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Sie können Ereignisziele deaktivieren. Nachdem Sie ein Ziel deaktiviert haben, sendet Stripe keine Ereignisse mehr an dieses Ziel. Wenn Sie das Ziel wieder aktivieren, sendet auch Stripe wieder Ereignisse an dieses.