Berechtigungsreferenz

Stripe Apps steuern den Zugriff auf Stripe API-Ressourcen über ein Berechtigungssystem. Jede Berechtigung muss explizit im App-Manifest mit einer klaren Zweckbeschreibung deklariert werden. Nutzer:innen genehmigen diese Berechtigungen bei der Installation deiner App.

Berechtigungen verwalten

Berechtigungen deklarieren

Trage die Berechtigungen in dein Manifest stripe-app.json ein:

{
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Read customer profiles to sync with Brevo contacts"
    },
    {
      "permission": "customer_write",
      "purpose": "Update customer metadata with Brevo sync status"
    }
  ]
}

Berechtigungen über die CLI erteilen

Während der Entwicklung erteilst du Berechtigungen mit der Stripe CLI:

# Grant a specific permission
stripe apps grant permission "customer_read" \
  --purpose "Read customer profiles to sync with Brevo contacts"

# Grant multiple permissions
stripe apps grant permission "charge_read" \
  --purpose "Access payment data for event tracking"

stripe apps grant permission "event_read" \
  --purpose "Subscribe to real-time Stripe events"

Best Practices für Berechtigungen

• Nur das Nötigste: Fordere ausschließlich Berechtigungen an, die deine App tatsächlich nutzt
• Klare Zwecke: Formuliere Zweckbeschreibungen, die auch nicht-technische Nutzer:innen verstehen
• Lesen und Schreiben begründen: Wenn du beides brauchst, erkläre in jedem Zweck, warum
• Regelmäßig prüfen: Entferne beim Aktualisieren deiner App die Berechtigungen, die du nicht mehr brauchst

Berechtigungen nach Produkt

Core

Payments

Billing

Checkout

Connect

Issuing

Reporting

Tax

Terminal

Secret Store

Empfohlene Berechtigungen für die Tajo Brevo-Integration

Für die Tajo Brevo-Integration empfehlen wir diese Berechtigungen:

{
  "permissions": [
    {
      "permission": "customer_read",
      "purpose": "Sync customer profiles and contact information to Brevo"
    },
    {
      "permission": "customer_write",
      "purpose": "Store Brevo contact ID and sync status on customer metadata"
    },
    {
      "permission": "charge_read",
      "purpose": "Track purchase events and revenue data for Brevo analytics"
    },
    {
      "permission": "product_read",
      "purpose": "Sync product catalog to Brevo for personalized email campaigns"
    },
    {
      "permission": "event_read",
      "purpose": "Listen to real-time events to trigger Brevo automation workflows"
    },
    {
      "permission": "invoice_read",
      "purpose": "Track invoice events for transactional emails via Brevo"
    },
    {
      "permission": "subscription_read",
      "purpose": "Monitor subscription lifecycle for Brevo retention campaigns"
    },
    {
      "permission": "secret_write",
      "purpose": "Securely store Brevo API credentials in Stripe Secret Store"
    },
    {
      "permission": "secret_read",
      "purpose": "Retrieve stored Brevo API credentials for data sync operations"
    },
    {
      "permission": "webhook_endpoint_write",
      "purpose": "Register webhook endpoints for real-time event delivery to Tajo"
    }
  ]
}

Berechtigungsbereiche

Berechtigungen wirken auf unterschiedlichen Ebenen, je nachdem, ob deine App auf einem Plattformkonto oder auf einem verbundenen Konto installiert ist: