Ereignisse an Amazon EventBridge senden

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

Führen Sie die folgenden Schritte aus, um Ereignisse in EventBridge zu empfangen. Dazu müssen Sie ein neues Ereignisziel in Workbench erstellen und die EventBridge-Konfiguration in der AWS Management-Konsole einrichten.

Neues Ereignisziel hinzufügen

Workbench

Ereignisse in Ihrer Sandbox senden

Verwenden Sie Ihr Live-Konto oder Sandboxes, um Ereignisse an Amazon EventBridge zu senden.

Erstellen Sie ein Ereignisziel mit Workbench im Dashboard oder programmgesteuert mit der API.

Dashboard

API

So erstellen Sie ein Ereignisziel im Dashboard:

1. Öffnen Sie die Registerkarte Webhooks in Workbench.
2. Klicken Sie auf Neues Ziel erstellen.
3. Wählen Sie aus, von wo Sie Ereignisse empfangen möchten. Stripe unterstützt zwei Arten von Konfigurationen: Ihr Konto und Verbundene Konten. Wählen Sie Konto aus, um Ereignisse von Ihrem eigenen Konto aus zu überwachen. Wenn Sie eine Connect-Anwendung erstellt haben und Ereignisse von Ihren verbundenen Konten überwachen möchten, wählen Sie Verbundene Konten aus.

Ereignisse von einem Ereignisziel der Organisation überwachen

Wenn Sie ein Ereignisziel in einem Organisationskonto erstellen, wählen Sie Konten aus, um Ereignisse von Konten in Ihrer Organisation zu überwachen. Wenn Ihre Organisationen Connect-Plattformen als Mitglieder haben und Ereignisse von allen verbundenen Konten der Plattformen überwachen möchten, wählen Sie Verbundene Konten aus.

1. Wählen Sie die Ereignistypen aus, die dieses Ziel empfangen soll. Klicken Sie dann auf Weiter.
2. Wählen Sie Amazon EventBridge als Zieltyp aus und klicken Sie dann auf Weiter.
3. 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 dieser Ereignisziel-Ressource in Stripe. Wenn Sie keine Angabe machen, generieren wir einen zufälligen Namen. Sie können dies später ändern.
   • (Optional) Beschreibung: Eine Beschreibung, die die Instance Ihres Ereignisziels von anderen unterscheidet. Sie können dies später ändern.
4. Klicken Sie auf Ziel erstellen.

Einen neuen Webhook über die Registerkarte Webhooks registrieren

Partner-Ereignisquelle zuordnen

AWS-Konsole

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.

1. Navigieren Sie in Ihrer AWS Console unter EventBridge zur Seite mit den Partnerereignisquellen. Die Seite finden Sie im Bereich Integration am linken Rand.

1. 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.

1. 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.partner/stripe.com/{UNIQUE_ID} der ARN überein. Klicken Sie dann auf Mit Event Bus verknüpfen.

1. Wählen Sie nach Bedarf Berechtigungen aus, die Sie für diesen Event Bus erteilen möchten, und klicken Sie dann auf Verknüpfen.

EventBridge-Regeln erstellen

AWS-Konsole

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.

1. Navigieren Sie zur AWS-Managementkonsole und klicken Sie dann auf Regeln.

1. Klicken Sie auf Regel erstellen und geben Sie einen Namen und eine Beschreibung der Regel an.

1. Wählen Sie Ihren Ereignisbus in der Dropdown-Liste aus. Um Ihren Ereignisbus zu finden, navigieren Sie zu Workbench, wählen Sie Ihr Ziel auf der Registerkarte Webhooks aus und zeigen Sie dann das Feld Ereignisquelle ARN an, das denselben Namen wie Ihre Ereignisquelle ARN hat. Klicken Sie dann auf Weiter.
2. Wählen Sie unter Ereignisquelle AWS-Ereignisse oder EventBridge-Partnerereignisse aus, da es sich bei Stripe-Ereignissen um Partnerereignisse handelt.

1. (Optional) Fügen Sie ein Stripe-Ereignisbeispiel hinzu.
2. Wählen Sie unter Erstellungsmethode die Option Musterformular verwenden aus, um ein vordefiniertes Muster zu verwenden. Alternativ können Sie ein benutzerdefiniertes Ereignismuster erstellen.

1. Wählen Sie unter Ereignismuster die Option EventBridge-Partner als Ereignisquelle aus.
2. Wählen Sie unter Ereignismuster Stripe als Partner aus.
3. 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.
4. 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.

1. Fügen Sie optionale Tags hinzu und klicken Sie dann auf Weiter.
2. Ü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.

Auslösen von Testereignissen

To send test events, trigger an event type that your event destination is subscribed to by manually creating an object in the Stripe Dashboard. Learn how to trigger events with Stripe for VS Code.

stripe trigger payment_intent.succeeded
Running fixture for: payment_intent
Trigger succeeded! Check dashboard for event details.

Verhaltensweisen der Ereignisübermittlung

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

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

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_id> --webhook-endpoint=<endpoint_id> command. This works for up to 30 days after the event creation.

Anordnung von Ereignissen

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.created (wenn eine Zahlung vorhanden ist)

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.paid abrufen, wenn Sie dieses Ereignis zuerst erhalten.

API-Versionierung

The API version in your account settings when the event occurs dictates the API version, and therefore the structure of an Event sent to your destination. For example, if your account is set to an older API version, such as 2015-02-16, and you change the API version for a specific request with versioning, the Event object generated and sent to your destination is still based on the 2015-02-16 API version. You can’t change Event objects after creation. For example, if you update a charge, the original charge event remains unchanged. As a result, subsequent updates to your account’s API version don’t retroactively alter existing Event objects. Retrieving an older Event by calling /v1/events using a newer API version also has no impact on the structure of the received event. You can set test event destinations to either your default API version or the latest API version. The Event sent to the destination is structured for the event destination’s specified version.

Status des Ereignisziels

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

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.created 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":[

Unterstützung von Ereignistypen, bei denen Stripe auf eine Antwort wartet

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_authorization.request in Amazon EventBridge-Zielen nicht abonnieren. Richten Sie stattdessen einen Webhook-Endpoint ein, um diesen Ereignistyp zu abonnieren. Verwenden Sie issuing_authorization.request, 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.
• Sie können checkout_sessions.completed 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 eines checkout_sessions.completed-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.

Gängige Architekturmuster mit EventBridge- und Stripe-Ereignissen

Berücksichtigen 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.