# Ereignisse überwachen

Überwachen Sie Ereignisse in den installierten Konten Ihrer Nutzer/innen

Apps können [Webhooks](https://docs.stripe.com/webhooks.md) verwenden, um Benachrichtigungen über Ereignisse in den Konten ihrer Nutzer/innen zu erhalten. Dadurch können App-Entwickler/innen bei Bedarf Informationen synchronisieren und Aktionen in der App auslösen.

## Loslegen

1. [Verarbeiten Sie Webhook-Ereignisse im Backend Ihrer App](https://docs.stripe.com/webhooks.md#webhook-endpoint-def).
1. [Registrieren Sie einen Webhook-Endpoint](https://docs.stripe.com/webhooks.md#webhooks-summary) im Stripe-Dashboard und wählen Sie die Option **Ereignisse von verbundenen Konten überwachen** aus.
1. (Recommended) Registrieren Sie einen Test-Webhook-Endpoint im Stripe-Dashboard. Sie können Apps im Live-Modus, [Test-Modus](https://docs.stripe.com/stripe-apps/build-backend.md#event-behavior-depends-on-install-mode) oder einer *Sandbox* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes) installieren. Wir empfehlen außerdem, einen Test-Endpoint einzurichten, um Testereignisse zu verarbeiten.
1. Fügen Sie Ihrer App die erforderlichen Berechtigungen hinzu, indem Sie `stripe apps grant permission` für jede App ausführen.
   ```bash
   stripe apps grant permission "PERMISSION_NAME" "EXPLANATION"
   ```
Ersetzen:
   - `PERMISSION_NAME` mit dem Berechtigungsnamen.
   - `EXPLANATION` mit einer Erklärung für die Aktivierung des Zugriffs. Nutzer/innen sehen diese Erklärung, wenn sie Ihre App installieren.

Sie müssen die Berechtigung `event_read` sowie alle sonstigen Berechtigungen hinzufügen, die mit den spezifischen Ereignissen verknüpft sind, die Sie bearbeiten möchten. Weitere Informationen darüber, welche Berechtigungen für ein bestimmtes Ereignis erforderlich sind, finden Sie unter [Ereignisberechtigungen](https://docs.stripe.com/stripe-apps/reference/permissions.md#event-permissions).

Wenn Sie beispielsweise die Ereignisse `payment_intent.succeeded` und `setup_intent.succeeded` verarbeiten möchten, führen Sie die folgenden Befehle aus:

```bash
stripe apps grant permission "event_read" "Read webhook event data"
stripe apps grant permission "checkout_session_read" "Read Checkout Session data in webhook events"
stripe apps grant permission "payment_intent_read" "Read PaymentIntent data in webhook events"
stripe apps grant permission "setup_intent_read" "Read SetupIntent data in webhook events"
```

Nachdem Sie diese Befehle ausgeführt haben, sieht Ihre App-Manifestdatei möglicherweise wie folgt aus:

```json
{
  "id": "com.example.app",
  "version": "1.2.3",
  "name": "Example App",
  "icon": "./example_icon_32.png","permissions": [
    {
      "permission": "event_read",
      "purpose": "Read webhook event data"
    },
    {
      "permission": "checkout_session_read",
      "purpose": "Read Checkout Session data in webhook events"
    },
    {
      "permission": "payment_intent_read",
      "purpose": "Read PaymentIntent data in webhook events"
    },
    {
      "permission": "setup_intent_read",
      "purpose": "Read SetupIntent data in webhook events"
    }
  ]
}
```

## Ereignisse in Ihrem Konto überwachen

So empfangen Sie Ereignisse für eine App, die nur für Nutzer/innen Ihres Kontos bestimmt ist:

1. Verarbeiten Sie [Webhook-Ereignisse](https://docs.stripe.com/webhooks.md#webhook-endpoint-def) im Backend Ihrer App.
1. [Registrieren Sie einen Webhook-Endpoint](https://docs.stripe.com/webhooks.md#webhooks-summary) im Stripe-Dashboard.

## Ereignisbenachrichtigungen über Ihre App empfangen

Überwachen Sie Ihre Stripe-App mithilfe eingehender *Webhooks* (A webhook is a real-time push notification sent to your application as a JSON payload through HTTPS requests) auf Ereignisse (z. B. Installationen oder Deinstallationen durch Nutzer/innen), damit Ihre Integration automatisch Reaktionen in Ihrem Backend auslösen kann, wie z. B.:

- Nutzerkonten erstellen
- Berechtigungen aktualisieren
- Konto eines/einer Nutzers/in deaktivieren und Daten entfernen

Zusätzlich zu den [Ereignistypen, die Stripe unterstützt](https://docs.stripe.com/api/events/types.md), unterstützt Stripe Apps auch die folgenden Ereignisse:

| Händleraktion                                      | Das resultierende Webhook-Ereignis wurde an das Backend der App gesendet                                                     |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| App verbinden oder installieren                    | [account.application.authorized](https://docs.stripe.com/api/events/types.md#event_types-account.application.authorized)     |
| Verbindung zur App trennen oder App deinstallieren | [account.application.deauthorized](https://docs.stripe.com/api/events/types.md#event_types-account.application.deauthorized) |

## Webhooks lokal testen

Sie können Webhooks lokal für Folgendes testen:

- Eine App, die nur für alle Nutzer/innen Ihres Kontos verfügbar ist und Ereignisse Ihres eigenen Kontos überwacht
- Eine App, die im Stripe App Marketplace verfügbar ist und Ereignisse für Konten überwacht, die Ihre App installiert haben

So testen Sie Webhooks lokal:

1. [Installieren Sie die Stripe-CLI](https://docs.stripe.com/stripe-cli.md).

1. Authentifizieren Sie Ihr Konto:

   ```bash
   stripe login
   ```

1. Öffnen Sie zwei Terminal-Fenster:

   - In einem Terminal-Fenster können Sie die [Ereignisweiterleitung einrichten](https://docs.stripe.com/webhooks.md#local-listener):

     #### Öffentlicher Eintrag im App-Marktplatz

     ```bash
     stripe listen --forward-connect-to localhost:{{PORT}}/webhook
     ```

     #### Nur privat für Ihr Konto

     ```bash
       stripe listen --forward-to localhost:{{PORT}}/webhook
     ```

   - In dem anderen Terminal-Fenster können Sie [Ereignisse zum Testen Ihrer Webhooks-Integration auslösen](https://docs.stripe.com/webhooks.md#trigger-test-events):

     #### Öffentlicher Eintrag im App-Marktplatz

     ```bash
     stripe trigger --stripe-account {{EVENT_NAME}}
     ```

     #### Nur privat für Ihr Konto

     ```bash
       stripe trigger {{EVENT_NAME}}
     ```

Weitere Informationen finden Sie in unserer Dokumentation zum [Testen eines Webhook-Endpoints](https://docs.stripe.com/webhooks.md#local-listener).

## See also

- [Serverseitige Logik](https://docs.stripe.com/stripe-apps/build-backend.md)
- [Dokumentation zu Berechtigungen](https://docs.stripe.com/stripe-apps/reference/permissions.md)
- [API-Authentifizierungstypen](https://docs.stripe.com/stripe-apps/api-authentication.md)
- [Ereignisziele](https://docs.stripe.com/event-destinations.md)
- [Webhooks](https://docs.stripe.com/webhooks.md)