Berechtigungen

Legen Sie fest, wann Sie Kundinnen/Kunden Zugriff auf Produktfunktionen gewähren oder den Zugriff widerrufen.

Mit Berechtigungen können Sie die Funktionen Ihrer internen Dienste Stripe-Produkten zuordnen. Nachdem Sie Ihre Funktionen zugeordnet haben, benachrichtigt Stripe Sie (je nach Abonnementstatus Ihrer Kundin/Ihres Kunden) basierend auf Ihren Zuordnungsoptionen, wann Sie den Zugriff auf welche Funktionen gewähren oder aufheben müssen.

Verwenden Sie Berechtigungen, um:

Ihre Preise einzurichten, zu ändern und mit diesen zu experimentieren, ohne Ihre Codebasis ändern zu müssen.
Funktionszugriff durch Kundinnen/Kunden gewähren, widerrufen und verwalten
Ihre Abrechnungsintegration zu vereinfachen.

Demo der Stripe Billing Entitlements API

Bevor Sie loslegen

In diesem Leitfaden wird davon ausgegangen, dass Sie bereits die Stripe-Ressourcen Abonnements und Kunde/Kundin verwenden.

Loslegen

So legen Sie mit Berechtigungen los:

Funktionen einrichten: Erstellen Sie jede Funktion in Stripe Billing mit der Feature API. Hier sind einige Beispiele für Funktionen, die Sie aufnehmen können.
- API-Zugriff
- KI-Assistent
- Premium-Support
- Erweiterte Berichterstattung
- Erweiterte Datenaufbewahrung
Funktionen zu Produkten hinzufügen: Fügen Sie Funktionen zu entsprechenden Stripe-Produkten hinzu. Sie können eine einzelne Funktion zu mehreren Produkten hinzufügen.
Aktive Kundenberechtigungen zuweisen: Wenn Kundinnen/Kunden Ihre Produkte abonnieren, schaltet Stripe Billing die Funktionen des bezahlten Produkts frei. Überwachen Sie den Webhook Active Entitlement Summary und verwenden Sie die List Active Entitlements API für bestimmte Kundinnen/Kunden, um die Bereitstellung Ihrer Funktionen einzuleiten.

Diagramm mit Berechtigungen und ihrer Beziehung zu einer Kundin/einem Kunden sowie den Funktionen des Produkts

Ihre Funktionen einrichten

Geben Sie für jede von Ihnen erstellte Funktion einen Namen und einen eindeutigen lookup_key an. Da der lookup_key für jede Funktion einzigartig ist, können Sie ihn nicht für mehrere Funktionen wiederverwenden.

Funktionen zu Produkten hinzufügen

Weisen Sie Ihre Funktion einem oder mehreren Produkten zu.

Notiz

Bestehende Abonnements erstellen zu Beginn des nächsten Abrechnungszeitraums aktive Berechtigungen für alle Funktionsänderungen an Produkten.

Nachdem Sie eine Anfrage zum Verknüpfen Ihrer Funktion mit Ihrem Produkt gesendet haben, erhalten Sie eine Antwort, die in etwa so aussieht:

{
  "id": "{{PRODUCT_FEATURE_ID}}",
  "object": "product_feature",
  "entitlement_feature": {
    "id": "{{ENTITLEMENTS_FEATURE_ID}}",
    "object": "entitlements.feature",
    "name": "My feature",
    "lookup_key": "myinternalfeaturecode"
  }
}

Führen Sie die mit einem Produkt verknüpften Funktionen auf, indem Sie die Liste der Produktfunktionen durchblättern:

Und eine Funktion können Sie aus einem bestimmten Produkt entfernen, indem Sie die Verknüpfung der Produktfunktion aufheben:

Aktive Berechtigungen der Kundinnen/Kunden zuweisen

Während des Lebenszyklus des Abonnements eines Kunden/einer Kundin, von der Aktivierung bis zu Upgrades, Downgrades usw. aktualisiert Stripe die Berechtigungen der Kundin/des Kunden basierend auf Ihren zugeordneten Funktionen.

Wenn ein Kundenabonnement zum allerersten Mal aktiviert wird, erstellt Stripe Berechtigungen für die Funktionen, die abonniert wurden.

Solange Kundinnen/Kunden eine Funktion aktiv abonnieren, behalten sie auch aktive Berechtigungen. Stellen Sie sicher, dass Ihr System allen Nutzerinnen/Nutzern, die die Berechtigung für diese Funktion besitzen, auch tatsächlich Zugriff auf diese gewährt.

Webhook-Ereignisse überwachen

Wenn Ihre Webhooks aktiviert sind, senden wir das folgende Webhook-Ereignis, um Sie zu benachrichtigen, wenn sich die Berechtigungen eines Kunden/einer Kundin ändern.

Im Übersichts-Webhook verfügbare eingeschränkte Berechtigungen

Die Eigenschaft active_entitlements der Berechtigungsübersicht enthält maximal 10 Berechtigungen. Wir bieten zudem eine URL, über die Sie die vollständige, paginierte Liste der Berechtigungen der Kundin/des Kunden abrufen können.

Ereignis	Beschreibung
`entitlements.active_entitlement_summary.updated`	Tritt jedes Mal auf, wenn sich die aktiven Berechtigungen einer Kundin/eines Kunden ändern.

Die Liste aller aktiven Berechtigungen einer Kundin/eines Kunden abrufen

Der Listen-Endpoint gibt eine paginierte Ansicht der aktiven Berechtigungen einer Kundin/eines Kunden zurück.

Empfehlung

Wir empfehlen Ihnen, diese Berechtigungen auch intern anzuwenden, um eine schnellere Lösung zu erzielen.

Notiz

Änderungen an Abonnementpreise, Plänen und Berechtigungen können bestimmten gesetzlichen Anforderungen unterliegen. Wenden Sie sich an Ihren Rechtsbeistand, um auf Ihr Unternehmen zugeschnittenen Rat zu erhalten.