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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
In diesem Leitfaden wird davon ausgegangen, dass Sie bereits die Stripe-Ressourcen Abonnements und Kunde/Kundin verwenden.
Loslegen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
So legen Sie mit Berechtigungen los:
- Funktionen einrichten: Erstellen Sie jede Funktion in Stripe Billing mit der Feature API. „E-Mail“ oder „SMS“ sind beispielsweise separate Funktionen.
- 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](https://b.stripecdn.com/docs-statics-srv/assets/entitlements-diagram.240f8f8017776fc513dd69f291daed0d.png)
Ihre Funktionen einrichten![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Geben Sie für jede von Ihnen erstellte Funktion einen Namen und einen eindeutigen lookup_
an. Da der lookup_
für jede Funktion einzigartig ist, können Sie ihn nicht für mehrere Funktionen wiederverwenden.
Funktionen zu Produkten hinzufügen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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_
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. | Tritt jedes Mal auf, wenn sich die aktiven Berechtigungen einer Kundin/eines Kunden ändern. |
Die Liste aller aktiven Berechtigungen einer Kundin/eines Kunden abrufen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
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.