# Ereignisse an Azure Event Grid senden

Verwenden Sie Stripe-Ereignisse in Ihrer Azure-Infrastruktur.

[Azure Event Grid](https://learn.microsoft.com/en-us/azure/event-grid/overview) ist ein skalierbarer, vollständig verwalteter Ereignis-Routing-Dienst, also ein Dienst zur Weiterleitung von Ereignissen, von Microsoft Azure. Durch die Integration von Event Grid unter Verwendung eines Ereignisziels können Sie Stripe-Ereignisse direkt an Ihre Azure-Infrastruktur weiterleiten, ohne Integrationscode oder eine Skalierungslogik der Infrastruktur verwalten zu müssen. Wenn Event Grid Ereignisse empfängt, kann es sie an [verschiedene Ereignis-Handler](https://learn.microsoft.com/en-us/azure/event-grid/event-handlers) weiterleiten – einschließlich [Webhooks](https://learn.microsoft.com/en-us/azure/event-grid/handler-webhooks), [Azure-Funktionen](https://learn.microsoft.com/en-us/azure/event-grid/handler-functions) oder [Event Hub](https://learn.microsoft.com/en-us/azure/event-grid/handler-event-hubs) –, um Geschäftsautomatisierungen zu verarbeiten oder auszulösen.

## Ereignisfluss von Stripe zu Event Grid

Stripe generiert Ereignisse, wenn Aktivitäten in Ihrem Konto stattfinden. Diese Ereignisse werden über ein [Azure-Partnerthema](https://learn.microsoft.com/en-us/azure/event-grid/concepts#partner-topics) in Ihrem [Azure-Abonnement](https://learn.microsoft.com/en-us/microsoft-365/enterprise/subscriptions-licenses-accounts-and-tenants-for-microsoft-cloud-offerings?view=o365-worldwide) (definiert als Ereignisziel in Stripe) an Event Grid gesendet. Anschließend werden diese Ereignisse von [Azure-Event-Abonnements](https://learn.microsoft.com/en-us/azure/event-grid/subscribe-through-portal) an Ihre konfigurierten [Ereignis-Handler](https://learn.microsoft.com/en-us/azure/event-grid/event-handlers) weitergeleitet, die die Daten gemäß Ihrer Geschäftslogik verarbeiten.

## Den Ressourcenanbieter für Event Grid registrieren [Azure-Portal]

Bevor Sie Event Grid verwenden können, müssen Sie den[Ressourcenanbieter](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/resource-providers-and-types) für Event Grid in Ihrem [Abonnement](https://learn.microsoft.com/en-us/microsoft-365/enterprise/subscriptions-licenses-accounts-and-tenants-for-microsoft-cloud-offerings?view=o365-worldwide) registrieren. Wenn Sie Event Grid zuvor in Ihrem Abo verwendet haben, gehen Sie zum nächsten Abschnitt über, um eine Partner-Autorisierung zu erstellen.

So registrieren Sie den Ressourcenanbieter für Event Grid Im Azure-Portal:

1. Wählen Sie in der Suchleiste **Abonnements** aus.
1. Wählen Sie in der Abonnement-Liste das Abo aus, das Sie für Event Grid verwenden möchten.
1. Klicken Sie auf der Seite **Abonnement** auf **Einstellungen** > **Ressourcenanbieter**.
1. Suchen Sie nach **Microsoft.EventGrid** und bestätigen Sie, dass der **Status** **Nicht registriert** ist. Wenn der Status **Registriert** ist, springen Sie zum nächsten Abschnitt und erstellen Sie eine Partner-Autorisierung.
1. Wählen Sie in der Anbieterliste **Microsoft.EventGrid** aus.
1. Wählen Sie in der Befehlsleiste **Registrieren** aus.
1. Aktualisieren Sie, um sicherzustellen, dass der Status von **Microsoft.EventGrid** in **Registriert** geändert wurde.

## Eine Partner-Autorisierung erstellen [Azure-Portal]

Erstellen Sie eine [Partner-Autorisierung](https://learn.microsoft.com/en-us/azure/event-grid/subscribe-to-partner-events#authorize-partner-to-create-a-partner-topic) im Azure-Portal, damit Stripe die Genehmigung hat, ein [Partnerthema](https://learn.microsoft.com/en-us/azure/event-grid/concepts#partner-topics) im [Abonnement](https://learn.microsoft.com/en-us/microsoft-365/enterprise/subscriptions-licenses-accounts-and-tenants-for-microsoft-cloud-offerings?view=o365-worldwide) und in der[Ressourcengruppe](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/overview#resource-groups), das/die Sie ausgewählt haben, zu erstellen.

1. Melden Sie sich beim Azure-Portal an.
1. Geben Sie in der Suchleiste oben **Partnerkonfigurationen** ein und wählen Sie in den Ergebnissen unter **Dienste** **Partnerkonfigurationen in Event Grid** aus.
1. Wählen Sie auf der Seite **Event Grid-Partnerkonfigurationen** in der Befehlsleiste **+ Erstellen** aus.
1. Führen Sie auf der Seite **Partnerkonfiguration erstellen** die folgenden Schritte aus:
1. Wählen Sie im Abschnitt **Projektdetails** das Abonnement und die Ressourcengruppe aus, in der Sie dem Partner erlauben möchten, ein Partnerthema zu erstellen.
1. Geben Sie im Abschnitt **Partnerautorisierungen** eine standardmäßige Ablaufzeit für Partnerautorisierungen, die in dieser Konfiguration definiert sind.
1. Um einer Partnerin oder einem Partner Ihre Autorisierung zum Erstellen von Partnerthemen in der angegebenen Ressourcengruppe zu erteilen, wählen Sie den Link **+ Partner-Autorisierung** aus.
1. Wählen Sie **Prüfen + erstellen** aus.
1. Führen Sie auf der Seite **Partner-Autorisierung hinzufügen, um Ressourcen zu erstellen** die folgenden Schritte aus, um Stripe zu autorisieren:
1. Wählen Sie **Stripe** aus der Liste der [verifizierten Partner](https://learn.microsoft.com/en-us/azure/event-grid/partner-events-overview#verified-partners) aus
1. Geben Sie das **Ablaufdatum der Autorisierung** an. Wenn Sie eine Integration für Event Grid konfigurieren, legen Sie einen Ablaufzeitraum der Konfiguration fest. Dieser bestimmt, wie lange Stripe neue Partnerthemen im Abonnement erstellen kann. Diese Autorisierung wird immer dann verwendet, wenn ein neues Stripe Ereignisziel mit dieser Abo-ID erstellt wird. Wir empfehlen, diesen Wert für die meisten Implementierungen auf 90 Tage festzulegen. Nach dem Ablaufdatum kann Stripe keine neuen Partnerthemen mehr im Abonnement erstellen. Bestehende Partnerthemen und die Bereitstellung von Ereignissen funktionieren auch nach Ablauf der Autorisierung weiter.
1. Wählen Sie **Hinzufügen** aus.
1. Rufen Sie die Seite **Partnerkonfiguration erstellen** auf und überprüfen Sie dann, ob die Partnerin oder der Partner zur Liste der Partner-Autorisierung unten hinzugefügt wurde.
1. Wählen Sie unten auf der Seite **Prüfen + erstellen** aus.
1. Prüfen Sie auf der Seite **Prüfen** alle Einstellungen und wählen Sie dann **Erstellen** aus, um die Registrierung der Partnerin oder des Partners zu erstellen.

## Neues Ereignisziel hinzufügen [Workbench]

> #### Ereignisse in Ihrer Sandbox senden
> 
> Verwenden Sie Ihr Live-Konto oder Ihre [Sandboxes](https://docs.stripe.com/sandboxes.md), um Ereignisse an Event Grid zu senden.

Erstellen Sie ein Ereignisziel mit Workbench im Dashboard oder programmgesteuert mit der [API](https://docs.stripe.com/api/v2/core/event-destinations.md).

#### Dashboard

So erstellen Sie ein Ereignisziel im Dashboard:

1. Öffnen Sie die Registerkarte [Webhooks](https://dashboard.stripe.com/workbench/webhooks) in Workbench.
1. Klicken Sie auf **Neues Ziel erstellen**.
1. Wählen Sie aus, von wo Sie Ereignisse empfangen möchten. Stripe unterstützt zwei Arten von Konfigurationen: **Ihr Konto** und [Verbundene Konten](https://docs.stripe.com/connect.md). Wählen Sie **Konto** aus, um Ereignisse von Ihrem eigenen Konto aus zu überwachen. Wenn Sie eine [Connect-Anwendung](https://docs.stripe.com/connect.md) 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 einer [Organisation](https://docs.stripe.com/get-started/account/orgs.md) erstellen, wählen Sie **Konten** aus, um Ereignisse von Konten in Ihrer Organisation zu überwachen, oder wählen Sie **Verbundene und v2-Konten** aus, um Ereignisse von Ihren verbundenen und v2-Konten in Ihrer Organisation zu überwachen.

1. Wählen Sie die [Ereignistypen](https://docs.stripe.com/api/events/types.md) aus, die dieses Ziel empfangen soll. Klicken Sie dann auf **Weiter**.
1. Wählen Sie **Azure Event Grid** als Zieltyp aus und klicken Sie dann auf **Weiter**.
1. Geben Sie folgende Informationen ein:
   - [Azure-Abo-ID](https://learn.microsoft.com/en-us/microsoft-365/enterprise/subscriptions-licenses-accounts-and-tenants-for-microsoft-cloud-offerings?view=o365-worldwide): Das Abonnement, in dessen Rahmen Ihr Stripe-Partnerthema erstellt wird, um Ereignisse zu empfangen.
   - [Azure-Ressourcengruppe](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/overview#resource-groups): Die Ressourcengruppe, die das Stripe-Partnerthema enthält.
   - [Azure-Region](https://aws.amazon.com/about-aws/global-infrastructure/regions_az/): Die Regionen, in denen das Stripe-Partnerthema bereitgestellt 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.
1. Klicken Sie auf **Ziel erstellen**.

#### API

Verwenden Sie die [API](https://docs.stripe.com/api/v2/event-destinations.md), um ein neues Ereignisziel für Event Grid zu erstellen. Im folgenden Beispiel benachrichtigt Stripe Sie, wenn ein Fehler bei der Validierung der [nutzungsbasierten Abrechnung](https://docs.stripe.com/billing/subscriptions/usage-based.md) ausgelöst wird.

Wenn Sie eine [Connect-Anwendung](https://docs.stripe.com/connect.md) erstellt haben und Ereignisse aus Ihren verbundenen Konten überwachen möchten, verwenden Sie den Parameter [events_from](https://docs.stripe.com/api/v2/core/event-destinations/create.md#v2_create_event_destinations-events_from) und setzen Sie dessen Wert auf `@accounts`. Für Ereignisziele vom Typ [Organisation](https://docs.stripe.com/get-started/account/orgs.md) verwenden Sie `@organization_members` für Ereignisse aus Konten in Ihrer Organisation oder `@organization_members/@accounts` für Ereignisse aus verbundenen Konten in Ihrer gesamten Organisation.

## Partnerthema aktivieren [Azure-Portal]

Nachdem Sie ein Ereignisziel eingerichtet haben, erstellt Stripe ein [Partnerthema](https://learn.microsoft.com/en-us/azure/event-grid/partner-events-overview-for-partners#customers-authorization-to-create-partner-topics) in dem Abonnement und der Region, die Sie bei der Konfiguration angegeben haben. Sie müssen das Partnerthema aktivieren, damit Stripe Ereignisse an das Partnerthema senden kann. Aktivieren Sie das Partnerthema innerhalb von 7 Tagen nach Erstellung des Ereignisziels. Wenn Sie es nicht innerhalb dieses Zeitraums verknüpfen, löscht Azure das Partnerthema automatisch. Nachdem ein Partnerthema gelöscht wurde, wird Ihr Stripe-Ereignisziel automatisch deaktiviert, und Sie müssen ein neues Ziel erstellen, um Ereignisse zu empfangen.

Klicken Sie in [Workbench](https://dashboard.stripe.com/webhooks) für Ihr Ereignisziel auf **Einrichtung in Azure abschließen**, um Ihr Partnerthema zu aktivieren.

### Alternativ können Sie manuell zu Ihrem Partnerthema im Azure-Portal navigieren

1. Suchen Sie in der Suchleiste des Azure-Portals nach **Partnerthemen in Event Grid** und wählen Sie diese aus.
1. Wählen Sie auf der Seite **Partnerthemen in Event Grid** das Stripe-Partnerthema aus. Bei Zielen im Live-Modus ist der Name des Partnerthemas identisch mit Ihrer Ereignisziel-ID (die mit „ed_“ beginnt). Bei Sandbox Zielen ist der Name des Partnerthemas Ihre Ereignisziel-ID, von der das Präfix „test_“ entfernt wird. Sie finden Ihre Ereignisziel-ID auf der Registerkarte **Webhooks** der **Workbench** von Stripe, indem Sie die Details Ihres Event-Grid-Ziels anzeigen.
1. Prüfen Sie die Aktivierungsnachricht und wählen Sie auf der Seite oder in der Befehlsleiste **Aktivieren** aus, um das Partnerthema vor dem auf der Seite genannten Ablaufdatum zu aktivieren.
1. Bestätigen Sie, dass der Status der Aktivierung auf **Aktiviert** gesetzt ist.

## Ereignis-Abonnements und Ereignis-Handler erstellen [Azure-Portal]

Nachdem Sie Ihr Stripe-Partner-Thema aktiviert haben, müssen Sie mindestens ein [Abonnement für Ereignisse](https://learn.microsoft.com/en-us/azure/event-grid/subscribe-through-portal) mit einem [Ereignis-Handler](https://learn.microsoft.com/en-us/azure/event-grid/event-handlers) erstellen, um Ihre Stripe-Ereignisse zu empfangen. Ein Abonnement für Ereignisse definiert, welche Ereignisse aus Stripe-Partnerthemen an bestimmte Ereignis-Handler weitergeleitet werden. Ohne diese Komponenten werden Ereignisse an Event Grid gesendet und 24 Stunden lang beibehalten. Sie werden jedoch an kein Ziel übermittelt.

Sie können diese Schritte mehrmals wiederholen, um mehrere Ereignis-Abonnements und Ereignis-Handler zu definieren:

1. Richten Sie in Ihrem Azure-Abonnement einen Dienst ein, der als Ereignis-Handler in Event Grid[unterstützt wird](https://docs.microsoft.com/en-us/azure/event-grid/event-handlers). Dieser Handler verarbeitet die Ereignisse, die Stripe an Ihr Partnerthema sendet. Sie können beispielsweise die Vorlage für den [Event Grid Viewer](https://learn.microsoft.com/en-us/azure/event-grid/custom-event-quickstart-portal#create-a-message-endpoint) verwenden, die eine [vorgefertigte Web-App](https://github.com/Azure-Samples/azure-event-grid-viewer) bereitstellt, um die vom Partnerthema empfangenen Stripe-Ereignisnachrichten anzuzeigen.
1. Geben Sie im Azure-Portal **Partnerthemen in Event Grid** in das Suchfeld ein und wählen Sie **Partnerthemen in Event Grid** aus.
1. Wählen Sie auf der Seite **Partnerthemen in Event Grid** das Stripe-Partnerthema aus der Liste aus. Bei Zielen im Live-Modus ist der Name des Partnerthemas identisch mit Ihrer Ereignisziel-ID (die mit „ed_“ beginnt). Bei Sandbox Zielen ist der Name des Partnerthemas Ihre Ereignisziel-ID, von der das Präfix „test_“ entfernt wird. Sie finden Ihre Ereignisziel-ID auf der Registerkarte **Webhooks** der **Workbench** von Stripe, indem Sie die Details Ihres Event-Grid-Ziels anzeigen.
1. Wählen Sie auf der Seite **Partnerthema in Event Grid** für das Partnerthema in der Befehlsleiste **+ Ereignis-Abonnement** aus.
1. Führen Sie auf der Seite **Ereignis-Abonnement erstellen** die folgenden Schritte aus:
1. Geben Sie einen **Namen** für das Ereignis-Abonnement ein.
1. Wählen Sie unter **Nach Ereignistypen filtern** die Arten von Ereignissen aus, die Ihr Abonnement empfängt.
1. Wählen Sie als **Endpoint-Typ** den Azure-Dienst aus, den Sie als Ereignis-Handler verwendet haben.
1. Wählen Sie **Endpoint-Link konfigurieren** aus.
1. Wählen Sie auf der Seite **Ereignis-Hub auswählen** Konfigurationen für den Endpoint und dann **Auswahl bestätigen** aus.
1. Wählen Sie auf der Seite **Ereignis-Abonnement erstellen** die Option **Erstellen** aus.

Ihre Stripe-Ereignisse werden jetzt erfolgreich an Ihr Partnerthema und die entsprechenden Ereignis-Handler übermittelt.

## Testereignisse auslösen

Um Testereignisse zu senden, lösen Sie einen Ereignistyp aus, den Ihr Ereignisziel abonniert hat, indem Sie manuell ein Objekt im Stripe-Dashboard erstellen. Erfahren Sie, wie Sie Ereignisse mit [Stripe für VS-Code](https://docs.stripe.com/stripe-vscode.md) auslösen können.

#### Snapshot-Ereignis auslösen

Sie können den folgenden Befehl entweder in der [Stripe Shell](https://docs.stripe.com/workbench/shell.md) oder in der [Stripe-CLI](https://docs.stripe.com/stripe-cli.md) verwenden. Dieses Beispiel löst das Ereignis `payment_intent.succeeded` aus:

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

#### Thin-Ereignis auslösen

Du kannst folgenden Befehl in der [Stripe-CLI](https://docs.stripe.com/stripe-cli.md). Dieses Beispiel löst ein `v1.billing.meter.error_report_triggered` Ereignis aus:

```bash
stripe trigger v1.billing.meter.error_report_triggered
Setting up fixture for: list_billing_meters
Running fixture for: list_billing_meters
Setting up fixture for: billing_meter
Running fixture for: billing_meter
Setting up fixture for: list_billing_meters_after_creation
Running fixture for: list_billing_meters_after_creation
Setting up fixture for: billing_meter_event_session
Running fixture for: billing_meter_event_session
Setting up fixture for: create_billing_meter_event_stream
Running fixture for: create_billing_meter_event_stream
Trigger succeeded! Check dashboard for event details.
```

## Hydration von Thin-Ereignissen

[Thin-Ereignisse](https://docs.stripe.com/event-destinations.md#thin-events) sind Benachrichtigungen, die Referenzinformationen zur API-Ressource enthalten, die sich auf das Ereignis bezieht. Wenn Sie sie an Azure Event Grid senden, können Sie diese Informationen verwenden, um das vollständige Ereignis- oder API Ressourcenobjekt abzurufen (auch bekannt als „Ereignishydration“). Im Azure-Portal können Sie diesen Prozess einrichten, indem Sie Ereignis-Abonnements mit den unterstützten [Ereignis-Handlern](https://learn.microsoft.com/azure/event-grid/event-handlers) Ihrer Wahl konfigurieren. Wenn Sie Thin-Ereignisse an [Webhook-Endpoints](https://docs.stripe.com/webhooks.md) senden, müssen Sie die vollständigen Ereignis- oder Ressourcendaten selbst über die API abrufen. Dieser Prozess liefert Ihnen frische Daten, indem Sie den aktuellen Status der mit jedem Ereignis verknüpften Ressource abrufen.

## Verhaltensweisen der Ereignisübermittlung

In diesem Abschnitt erfahren Sie, welche Verhaltensweisen Sie in Bezug auf das Senden von Ereignissen durch Stripe an Azure Event Grid 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

Sie können Ereignisse nicht manuell erneut an Azure Event Grid senden.

### 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

Die API-Version in Ihren Kontoeinstellungen beim Auftreten des Ereignisses bestimmt die API-Version und damit die Struktur eines [Ereignisses](https://docs.stripe.com/api/events.md), das an Ihr Ziel gesendet wird. Wenn für Ihr Konto beispielsweise eine ältere API-Version festgelegt ist, z. B. 16.02.2015, und Sie die API-Version mit [Versionierung](https://docs.stripe.com/api.md#versioning) für eine bestimmte Anfrage ändern, basiert das generierte und an Ihr Ziel gesendete [Ereignis](https://docs.stripe.com/api/events.md)-Objekt weiterhin auf der API-Version 2015-02-16. Sie können [Ereignis](https://docs.stripe.com/api/events.md)-Objekte nach der Erstellung nicht mehr ändern. Wenn Sie beispielsweise eine Zahlung aktualisieren, bleibt das ursprüngliche Zahlungsereignis unverändert. Nachfolgende Aktualisierungen der API-Version Ihres Kontos ändern daher vorhandene [Ereignis](https://docs.stripe.com/api/events.md)-Objekte nicht rückwirkend. Auch das Abrufen eines älteren [Ereignisses](https://docs.stripe.com/api/events.md) durch Aufrufen von `/v1/events` mithilfe einer neueren API-Version wirkt sich nicht auf die Struktur des empfangenen Ereignisses aus. Sie können Testereignisziele entweder auf Ihre Standard-API-Version oder die neueste API-Version festlegen. Das an das Ziel gesendete [Ereignis](https://docs.stripe.com/api/events.md) ist für die angegebene Version des Ereignisziels strukturiert.

## Status des Ereignisziels

Event-Grid-Ziele haben mehrere Status, die ihre Bereitschaft zum Empfangen von Ereignissen beschreiben:

- **Aktiv**: Stripe sendet Ereignisse an Event Grid, wenn Sie das Partnerthema in Azure aktiviert haben.
- **Deaktiviert**: Stripe sendet keine Ereignisse an Event Grid. Ihr Ziel befindet sich entweder in diesem Status, weil Sie es manuell deaktiviert haben oder weil Stripe es aufgrund einer abgelaufenen Partnerthemenaktivierung automatisch deaktiviert hat.

## Ereignisstruktur

Event Grid übermittelt Ereignisse mithilfe des CloudEvents-Schemas (`v1.0`), bei dem es sich um eine offene Spezifikation zum Standardisieren des Ereignisdatenaustauschs handelt. Wenn Sie Stripe-Ereignisse über Event Grid empfangen, wird das ursprüngliche JSON-Objekt des Stripe-Ereignisses in die `Dateneigenschaft` innerhalb des CloudEvents-Envelopes eingeschlossen.

Nachfolgend finden Sie ein Beispiel für ein über Event Grid übermitteltes Ereignis vom Typ `v1.billing.meter.error_report_triggered`:

```json
{
  "specversion": "1.0",			
  "type": "v1.billing.meter.error_report_triggered",			
  "source": "/providers/stripe/ed_test_61StH5LQO42M712JD16Sr8c00mSQTEEmwCfiQq4wqQc4",
  "id": "9aeb0fdf-c01e-0131-0922-9eb54906e209",	
  "time": "2025-07-11T14:30:00Z",
  "subject": null,
  "dataContentType": "application/cloudevents+json",
  "data": {
    {
      "id": "evt_test_65R9Ijk8dKEYZcXeRWn16R9A7j1FSQ3w3TGDPLLGSM4CW0",
      "object": "v2.core.event",
      "type": "v1.billing.meter.error_report_triggered",
      "livemode": false,
      "created": "2024-09-17T06:20:52.246Z",
      "related_object": {
        "id": "mtr_test_61R9IeP0SgKbYROOx41PEAQhH0qO23oW",
        "type": "billing.meter",
        "url": "/v1/billing/meters/mtr_test_61R9IeP0SgKbYROOx41PEAQhH0qO23oW"
      }
    }
  }
}
```

## Ereignistypen unterstützen, 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.

Event-Grid-Ziele unterstützen nur eingeschränkt Ereignistypen, die eine Antwort erfordern:

- Sie können den Ereignistyp `issue_authorisierung.request` für EventGrid-Ziele nicht abonnieren. Richten Sie stattdessen einen [Webhook-Endpoint](https://docs.stripe.com/webhooks.md) ein, um diesen Ereignistyp zu abonnieren. Verwenden Sie `issue_authorisierung.request`, um Kaufanfragen in Echtzeit zu autorisieren. Dies erfordert, dass Ihr Ziel Anfragen genehmigt oder ablehnt, indem es auf das Ereignis antwortet. Vor dem Senden an Ihre Kundinnen und Kunden übernimmt Event Grid die Antwort an Stripe. Folglich kann dieser Zieltyp diesen Ereignistyp nicht verwendet, um jegliche Zahlungen zu autorisieren.
- Sie können `checkout_sessions.completed` abonnieren, wenn Sie Event Grid verwenden. Dadurch wird jedoch kein [Weiterleitungsverhalten verarbeitet](https://docs.stripe.com/checkout/fulfillment.md#redirect-hosted-checkout), wenn Sie [Checkout](https://docs.stripe.com/payments/checkout.md) direkt in Ihre Website einbetten oder Kundinnen/Kunden auf eine von Stripe gehostete Zahlungsseite weiterleiten. Die Übermittlung eines `checkout_sessions.completed`-Ereignisses an Event Grid wirkt sich nicht auf das Weiterleitungsverhalten aus. Um das Checkout-Weiterleitungsverhalten zu ändern, verarbeiten Sie diesen Ereignistyp mit einem [Webhook-Endpoint](https://docs.stripe.com/webhooks.md).

## See also

- [Liste der schlanken Ereignistypen](https://docs.stripe.com/api/v2/core/events/event-types.md)
- [Liste der Snapshot-Ereignistypen](https://docs.stripe.com/api/events/.md)
- [Übersicht der Ereignisziele](https://docs.stripe.com/event-destinations.md)
- [Ereignisse an Webhook-Endpoints senden](https://docs.stripe.com/webhooks.md)