Ereignisse an Amazon EventBridge sendenBeta
Nutzen Sie Stripe-Ereignisse in Ihrer AWS-Infrastruktur.
Amazon EventBridge ist ein ereignisgestützter Dienst von AWS, der ohne Server auskommt und Ihre Anwendungen zentral zusammenfasst. AWS erleichtert Ihnen die Verarbeitung, Anpassung und Übermittlung von Ereignissen. Wenn Sie eine Integration mit EventBridge und einem Ereignisziel vornehmen, können Sie Ereignisdaten von Stripe direkt über Ihr AWS-Konto empfangen. Um Datenverkehr und die Codelogik der Integration brauchen Sie sich dann nicht mehr kümmern. Wenn Ereignisse empfangen werden, kann EventBridge diese an 20 unterstützte Ziele weiterleiten und so automatische Vorgänge in Ihrem Unternehmen verarbeiten oder auslösen.
Ereignisse an Amazon EventBridge senden![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Führen Sie die nachfolgenden Schritte aus, um Ereignisse in EventBridge zu erhalten. Hierfür müssen Sie zunächst ein neues Ereignisziel in Workbench erstellen und die EventBridge-Konfiguration in der AWS Management Console einrichten.
Achtung
Sie erhalten erst Ereignisdaten in Ihrem Amazon EventBridge, wenn Sie alle Schritte abgeschlossen haben.
Neues Ereignisziel hinzufügenWorkbench![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Ereignisse in Ihrer Sandbox senden
Verwenden Sie Ihr Live-Konto oder Sandboxes, um Ereignisse an Amazon EventBridge zu senden.
Öffnen Sie Workbench im Stripe-Dashboard und klicken Sie dann auf die Registerkarte Ereignisziele.
Klicken Sie auf Neues Ziel erstellen.
Wählen Sie die Ereignisse aus, die Sie an Amazon EventBridgeNext senden möchten, und klicken Sie dann auf Weiter. Wenn Sie Connect verwenden, können Sie Ereignisse auswählen, die Sie von Ihren verbundenen Konten erhalten möchten, indem Sie Ereignisse auf verbundenen Konten auswählen.
Wählen Sie Amazon EventBridge als Zieltyp aus und klicken Sie dann auf Weiter.
Geben Sie folgende Informationen ein:
- AWS-Konto-ID: Das AWS-Konto, das Ihre EventBridge-Instanz für den Empfang von Ereignissen hostet.
- AWS-Region: Die AWS-Region, in der Ihre EventBridge-Instanz zum Empfangen von Ereignissen gehostet wird.
- (Optional) Zielname: Ein eindeutiger Name für diese Ereigniszielressource in Stripe. Wenn Sie keine Angabe machen, generieren wir einen zufälligen Namen. Sie können dies später jederzeit ändern.
- (Optional) Beschreibung: Eine Beschreibung, die die Instanz Ihres Ereignisziels von anderen unterscheidet. Sie können dies später jederzeit ändern.
Klicken Sie auf Ziel erstellen.
Partnerereignisquelle verknüpfenAWS Console![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Nachdem Sie ein Ereignisziel eingerichtet haben, erstellt Stripe eine Partner-Ereignisquelle im AWS-Konto und der Region, die Sie bei der Konfiguration angegeben haben. Um mit dem Empfang von Ereignissen zu beginnen, müssen Sie diese Ereignisquelle innerhalb von 7 Tagen nach der Erstellung des Ereignisziels mit einem Event Bus verknüpfen. Wenn Sie keine Zuordnung innerhalb dieses Zeitraums vornehmen, löscht Amazon die ausstehende Ereignisquelle automatisch. Nachdem eine Ereignisquelle gelöscht wurde, wird Ihr Stripe-Ereignisziel automatisch deaktiviert, und Sie müssen ein neues Ziel erstellen, um Ereignisse zu empfangen.
- Navigieren Sie in Ihrer AWS Console unter EventBridge zur Seite mit den Partnerereignisquellen. Die Seite finden Sie im Bereich Integration am linken Rand.
![Navigieren Sie zu **Partnerereignisquellen**](https://b.stripecdn.com/docs-statics-srv/assets/aws-select-partner-event-source.14ff917248eeb4f333195e6b3a431447.png)
- Verwenden Sie die Dropdown-Liste Region oben in der Konsole, um die Region auszuwählen, die Sie beim Konfigurieren Ihres Ereignisziels in Workbench auswählen.
![AWS-Region auswählen](https://b.stripecdn.com/docs-statics-srv/assets/aws-region.6a68960287ba6356f8e856501295a039.png)
- Wählen Sie im Dropdown-Menü die neu erstellte Partner-Ereignisquelle aus. Um das Feld „Ereignisquelle ARN“ in Workbench zu finden, wählen Sie Ihr Ereignisziel aus. Ihre Partnerquelle stimmt mit dem Teil
event-source/aws.
der ARN überein. Klicken Sie dann auf Mit Event Bus verknüpfen.partner/stripe. com/{UNIQUE_ ID}
![Partnerereignisquelle mit dem Event Bus verknüpfen](https://b.stripecdn.com/docs-statics-srv/assets/aws-associate-partner-event-source.c89d540961356ff06e3fb095956ba80f.png)
- Wählen Sie nach Bedarf Berechtigungen aus, die Sie für diesen Event Bus erteilen möchten, und klicken Sie dann auf Verknüpfen.
![Berechtigungen auswählen und Zuordnung abschließen](https://b.stripecdn.com/docs-statics-srv/assets/aws-associate-event-bus.28dcbc4781d814799076258c8f1b9a04.png)
EventBridge-Regel(n) erstellenAWS Console![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
EventBridge gruppiert und leitet Ereignisse basierend auf von Ihnen definierten Regeln weiter. Nachdem Sie ein Ereignisziel erstellt und dessen Partner-Ereignisquelle einem Event Bus zugeordnet haben, müssen Sie Regeln definieren. So stellen Sie sicher, dass EventBridge weiß, wie die auf dem Event Bus empfangenen Ereignisse zu behandeln sind. Sie können diese Schritte mehrmals wiederholen, um mehrere Regeln zu definieren.
- Navigieren Sie zur AWS Management Console und klicken Sie dann auf Regeln.
![Navigieren Sie zu **Regeln**](https://b.stripecdn.com/docs-statics-srv/assets/aws-select-rules.f385d0e668caafc9614584e2ae635138.png)
- Klicken Sie auf Regel erstellen und geben Sie dann einen Namen und eine Beschreibung der Regel an.
![Name und Beschreibung der Regel angeben](https://b.stripecdn.com/docs-statics-srv/assets/aws-define-rule.ce885bcbea4d7492f082eba2f38fd840.png)
- Wählen Sie den gewünschten Event Bus aus der Dropdown-Liste aus. Um Ihren Event Bus zu finden, navigieren Sie zu Workbench, wählen Ihr Ziel auf der Registerkarte Ereignisziel aus und zeigen Sie dann das Feld Ereignisquelle ARN an, das denselben Namen wie Ihre Ereignisquellen ARN hat. Klicken Sie dann auf Weiter.
- Wählen Sie unter Ereignisquelle AWS-Ereignisse oder EventBridge-Partnerereignisse aus, da es sich bei Stripe-Ereignissen um Partnerereignisse handelt.
![Ereignisquelle auswählen](https://b.stripecdn.com/docs-statics-srv/assets/aws-event-source.29ee4d4e795b0f7d89db7163ab7b9ac5.png)
- (Optional) Fügen Sie ein Stripe-Ereignisbeispiel hinzu.
- Wählen Sie unter Erstellungsmethode die Option ** Musterform verwenden** aus, um ein vordefiniertes Muster zu verwenden. Alternativ können Sie auch ein benutzerdefiniertes Ereignismuster erstellen.
![Ein vordefiniertes Regelmuster verwenden](https://b.stripecdn.com/docs-statics-srv/assets/aws-create-rule-pattern.3246a6c5a409b1b0571f56acc6e7b91b.png)
- Wählen Sie unter Ereignismuster die Option EventBridge-Partner als Ereignisquelle aus.
- Wählen Sie unter Ereignismuster Stripe als Partner aus.
- Wählen Sie den entsprechenden Ereignistyp aus, für den Sie eine Regel erstellen möchten. Sie können auch Alle Ereignisse auswählen, um diese Regel mit allen Ereignistypen abzugleichen. Klicken Sie anschließend auf Weiter.
- Wählen Sie das Ziel aus, an das diese Regel Ereignisse senden soll, und klicken Sie auf Weiter.
Empfehlung
Wir empfehlen Ihnen, für jeden Event Bus ein CloudWatch Logs-Ziel zu erstellen, um die Überwachung für Ihr Ereignisziel zu ermöglichen. Ziehen Sie in Betracht, andere gängige Architekturmuster mit EventBridge- und Stripe-Ereignissen zu verwenden.
![Regelziel auswählen](https://b.stripecdn.com/docs-statics-srv/assets/aws-select-target.d9da569a26cf0d6fcc81f753b16d0e60.png)
- Fügen Sie optionale Tags hinzu und klicken Sie dann auf Weiter.
- Überprüfen Sie Ihre Regel und nehmen Sie bei Bedarf Änderungen vor. Klicken Sie dann auf Regel erstellen.
Ihre Stripe-Ereignisse werden nun erfolgreich an EventBridge und die entsprechenden in Ihrer Regel definierten Ziele gesendet.
Testereignisse auslösen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Um Testereignisse zu senden, lösen Sie einen Ereignistyp aus, den Ihr Webhook abonniert hat, indem Sie manuell ein Objekt im Stripe-Dashboard erstellen. Alternativ können Sie den folgenden Befehl in der Stripe Shell oder der Stripe-CLI verwenden:
Dieses Beispiel löst ein payment_
-Ereignis aus:
stripe trigger payment_intent.succeeded Running fixture for: payment_intent Trigger succeeded! Check dashboard for event details.
Erfahren Sie, wie Sie Ereignisse mit Stripe für VS Code auslösen können.
Verhaltensweisen der Ereignisübermittlung![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
In diesem Abschnitt erfahren Sie, welche Verhaltensweisen Sie in Bezug auf das Senden von Ereignissen durch Stripe an Amazon EventBridge erwarten können.
Automatische Wiederholungsversuche![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe versucht, Ereignisse mit einem exponentiellen Backoff im Live-Modus bis zu drei Tage an Ihr Ziel zu senden. Wann der nächste Wiederholungsversuch stattfinden wird, sofern zutreffend, sehen Sie auf der Registerkarte Ereignisübermittlungen Ihres Ereignisziels. Wir versuchen, Ereignisse, die in einer Sandbox erstellt wurde, innerhalb weniger Stunden dreimal zu übermitteln. Wenn Ihr Ziel bei unserem Wiederholungsversuch deaktiviert oder gelöscht wurde, unternehmen wir keine zukünftigen Wiederholungsversuche für dieses Ereignis. Wenn Sie ein Ereignisziel jedoch deaktivieren und wieder reaktivieren, bevor wir einen erneuten Versuch starten können, sehen Sie nach wie vor zukünftige Wiederholungsversuche.
Manuelle Wiederholungsversuche![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
There are two ways to manually retry events:
- In the Stripe Dashboard, click Resend when looking at a specific event. This works for up to 15 days after the event creation.
- With the Stripe CLI, run the
stripe events resend <event_
command. This works for up to 30 days after the event creation.id> --webhook-endpoint=<endpoint_ id>
Anordnung von Ereignissen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe garantiert die Übermittlung von Ereignissen nicht in der Reihenfolge, in der sie generiert wurden. Beim Erstellen eines Abonnements können beispielsweise die folgenden Ereignisse generiert werden:
customer.
subscription. created invoice.
created invoice.
paid charge.
(wenn eine Zahlung vorhanden ist)created
Stellen Sie sicher, dass Ihr Ereignisziel Ereignisse nicht nur in einer bestimmten Reihenfolge empfangen kann. Ihr Ziel sollte jegliche Übermittlung entsprechend verarbeiten können. Sie können fehlende Objekte auch mit der API abrufen. So können Sie beispielsweise die Objekte für Rechnung, Zahlung und Abonnement mit den Informationen aus invoice.
abrufen, wenn Sie dieses Ereignis zuerst erhalten.
API-Versionierung![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Die API-Version in Ihren Kontoeinstellungen, die zum Zeitpunkt genutzt wird, an dem das Ereignis auftritt, bestimmt die API-Version und damit die Struktur eines Ereignisses, das an Ihr Ziel gesendet wird. Wenn für Ihr Konto beispielsweise eine ältere API-Version festgelegt ist, zum Beispiel 2015-02-16, und Sie die API-Version für eine bestimmte Anforderung mit der Versionierung ändern, basiert das generierte und an Ihr Ziel gesendete Ereignis-Objekt weiterhin auf der API-Version 2015-02-16. Sie können Ereignis-Objekte nach der Erstellung nicht mehr ändern. Wenn Sie beispielsweise eine Zahlung aktualisieren, bleibt das ursprüngliche Zahlungsereignis unverändert. Folglich ändern nachfolgende Aktualisierungen der API-Version Ihres Kontos nicht rückwirkend vorhandene Ereignis-Objekte. Das Abrufen eines älteren Ereignisses durch den Aufruf von /v1/events
mit einer neueren API-Version hat ebenfalls keinen Einfluss auf die Struktur des empfangenen Ereignisses. Sie können Testereignisziele sowohl für Ihre Standard-API-Version als auch die neueste API-Version festlegen. Das an das Ziel gesendete Ereignis ist für die angegebene Version des Ereignisziels strukturiert.
Status des Ereignisziels![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Amazon EventBridge-Ziele haben mehrere Status, die seine Bereitschaft zum Empfangen von Ereignissen beschreiben:
Aktiv: Sie haben das Ereignisziel erfolgreich mit einem Ereignisbus verknüpft. Wenn Sie eine EventBridge-Regel richtig konfigurieren, erhalten Sie die Ereignisse in den von Ihnen gewünschten Ereigniskonsumenten.
Deaktiviert: Stripe sendet keine Ereignisse an Amazon EventBridge. Ihr Ziel befindet sich entweder in diesem Status, weil Sie es manuell deaktiviert haben oder weil Stripe es aufgrund einer AWS-Fehlkonfiguration automatisch deaktiviert hat.
Ausstehend: Nachdem das Ereignisziel erfolgreich eine Partner-Ereignisquelle in AWS erstellt hat, müssen Sie diese Ereignisquelle mit einem Ereignisbus verknüpfen. Das Ziel bleibt in einem ausstehenden Zustand und erhält keine Ereignisse, bis Sie diese Zuordnung vornehmen. Zu diesem Zeitpunkt ändert sich der Status des Ziels in aktiv.
Ereignisstruktur![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
EventBridge verwendet eine eigene Ereignisstruktur, die das JSON-Ereignis des Stripe-event
in einem detail
-Feld auf oberster Ebene umschließt.
Dieses Beispiel ist eine customer.
erstellte Ereignisnutzlast von EventBridge:
{ "version":"0", "id":"17e8dff5-d6cd-3770-ace9-aeac02b6ac3f", "detail-type":"customer.created", "source":"aws.partner/stripe.com/ed_61PgtRTG5aTCIz98516PLsRGLISQK0Otk6FWKjBrcDia", "account":"506417113029", "time":"2024-03-07T18:27:56Z", "region":"us-west-2", "resources":[
Support-Ereignistypen, bei denen Stripe auf eine Antwort wartet![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Stripe sendet die meisten Ereignistypen asynchron. Für bestimmte Ereignistypen wartet Stripe jedoch auf eine Antwort. Das Vorhandensein oder Nichtvorhandensein einer Antwort vom Ereignisziel wirkt sich direkt darauf aus, wie Stripe mit diesen bestimmten Ereignistypen umgeht.
Amazon EventBridge-Ziele bieten eingeschränkten Support für Ereignistypen, für die eine Antwort erforderlich ist:
- Sie können den Ereignistyp
issuing_
in Amazon EventBridge-Zielen nicht abonnieren. Richten Sie stattdessen einen Webhook-Endpoint ein, um diesen Ereignistyp zu abonnieren. Verwenden Sieauthorization. request issuing_
, um Kaufanfragen in Echtzeit zu autorisieren. Dies erfordert, dass Ihr Ziel Anfragen genehmigt oder ablehnt, indem es auf das Ereignis antwortet. EventBridge verarbeitet die Antwort an Stripe, bevor es an Ihre Kundinnen/Kunden gesendet wird. Folglich kann dieser Zieltyp diesen Ereignistyp nicht verwenden, um Zahlungen zu autorisieren.authorization. request - Sie können
checkout_
abonnieren, wenn Sie Amazon EventBridge verwenden. Dadurch wird jedoch kein Weiterleitungsverhalten verarbeitet, wenn Sie Checkout direkt in Ihre Website einbetten oder Kundinnen/Kunden auf eine von Stripe gehostete Bezahlseite weiterleiten. Die Übermittlung einessessions. completed checkout_
-Ereignisses an Amazon EventBridge wirkt sich nicht auf das Weiterleitungsverhalten aus. Um das Verhalten der Checkout-Weiterleitung zu ändern, verarbeiten Sie diesen Ereignistyp mit einem Webhook-Endpoint.sessions. completed
Gängige Architekturmuster von EventBridge- und Stripe-Ereignissen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Beachten Sie die folgenden Architekturmuster, wenn Sie Amazon EventBridge mit Stripe verwenden:
- Funktionen ohne Server mit Lambda auslösen, um Unternehmensautomatisierungen zu definieren: Senden Sie Stripe-Ereignisse von EventBridge an Lambda, um Computing-Funktionen ohne Server auszulösen, zum Beispiel das Erstellen eines Versandetiketts nach erfolgreicher Zahlung.
- Ereignisüberwachung mit CloudWatch aktivieren: Senden Sie Ereignisse von EventBridge an CloudWatch Logs, um Ereignisse als Log-Daten zu speichern, die Sie interaktiv durchsuchen und analysieren können. Überwachen Sie Nutzungsmuster und Fehler mit CloudWatch. Erwägen Sie die Einrichtung von Warnmeldungen bei Fehlern (zum Beispiel bei einem Verstoß gegen eine EventBridge-Regel).
- Low- und No-Code-Workflows mit Step Functions auslösen: Senden Sie Ereignisse, die Ihre Geschäftsszenarien auslösen, z. B. Benachrichtigung Ihrer Kundinnen/Kunden darüber, dass ihr Testzeitraum bald endet, an einen StepFunction-Workflow.
- Ereignisse an interne Systeme mit Simple Notification Service (SNS) oder Simple Queue Service (SQS) weiterleiten: Senden Sie Stripe-Ereignisse an SNS oder SQS, um Stripe-Ereignisdaten an Ihre internen Teams weiterzuleiten, um sicherzustellen, dass diese sie besitzen und verarbeiten können.
Einschränkungen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Es gibt mehrere Einschränkungen bei der Verwendung von Amazon EventBridge:
- Sie können Ereignisziele nicht programmgesteuert über die API konfigurieren.
- In Workbench werden auf den Registerkarten Übersicht und Ereignisziele keine Diagramme zur Ereignisübermittlung angezeigt, die Datenverkehr zu Amazon EventBridge-Zielen enthalten.
- In Workbench werden auf der Registerkarte Ereignisse keine Ereignisübermittlungen an Amazon EventBridge-Ziele angezeigt.
- Durch das Aktivieren von Ereigniszielen in einem Sandbox- oder Live-Modus-Konto wird die Funktion nicht auch automatisch in Ihren anderen Umgebungen aktiviert. Sie müssen Ereignisziele separat für jede Sandbox- oder Live-Modus-Umgebung aktivieren, in der Sie diese verwenden möchten.