# 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. - Gewähren, widerrufen und verwalten Sie den Zugriff Ihrer Kundschaft auf Funktionen - Ihre Abrechnungsintegration zu vereinfachen. ![](https://d37ugbyn3rpeym.cloudfront.net/videos/entitlements-demo.mp4) ## Before you begin In diesem Leitfaden wird davon ausgegangen, dass Sie bereits die Stripe-Ressourcen [Abonnements](https://docs.stripe.com/billing/subscriptions/build-subscriptions.md) und [Kunde/Kundin](https://docs.stripe.com/invoicing/customer.md) verwenden. # Dashboard > This is a Dashboard for when dashboard-or-api is dashboard. View the full page at https://docs.stripe.com/billing/entitlements?dashboard-or-api=dashboard. ## Loslegen So legen Sie mit Berechtigungen los: - **Ihre Funktionen einrichten** ein: Erstellen Sie jede Funktion in Stripe Billing vom Dashboard aus. Im Folgenden finden Sie einige Beispiele für Funktionen, die Sie hinzufügen können: - API-Zugriff - KI-Assistent - Premium-Support - Erweiterte Berichterstattung - Erweiterte Datenaufbewahrung - **Ihre 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. - **Ihre Funktionen verwalten**: Bearbeiten oder archivieren Sie jede Funktion vom Dashboard aus. ## Ihre Funktionen einrichten Gehen Sie wie folgt vor, um eine Funktion im Dashboard zu erstellen: 1. Rufen Sie im Dashboard den [Produktkatalog](https://dashboard.stripe.com/products) auf und klicken Sie auf **Funktionen**. 1. Klicken Sie auf **+ Funktion erstellen** und geben Sie einen Namen und einen Suchschlüssel für die Funktion ein. Optional können Sie auch Metadaten hinzufügen. 1. Da der Lookup-Schlüssel für jede Funktion eindeutig ist, können Sie ihn nicht für verschiedene Funktionen wiederverwenden, es sei denn, Sie archivieren die mit dem Lookup-Schlüssel verknüpfte Funktion. 1. Klicken Sie auf **Funktion erstellen**. ## Funktionen zu Produkten hinzufügen Gehen Sie wie folgt vor, um einem Produkt im Dashboard eine Funktion hinzuzufügen: 1. Klicken Sie im Dashboard auf der Registerkarte [Funktionen](https://dashboard.stripe.com/features) auf die Funktion, die Sie hinzufügen möchten. 1. Klicken Sie auf **An Produkt anhängen** und wählen Sie ein Produkt aus dem Menü aus. 1. Klicken Sie auf **Bestätigen**. Wenn Kundinnen/Kunden ein Produkt abonnieren, können Sie sehen, auf welche Funktionen diese Anspruch haben. Gehen Sie dazu auf die Seite [Kundinnen/Kunden](https://dashboard.stripe.com/customers), wählen Sie die Kundin/den Kunden aus und lesen Sie den Abschnitt „Berechtigungen“. > Bestehende Abonnements erstellen zu Beginn des nächsten Abrechnungszeitraums aktive Berechtigungen für alle Funktionsänderungen an Produkten. ## Funktionen verwalten Sie können Funktionen über das Dashboard verwalten. ### Eine Funktion bearbeiten Um den Namen einer Funktion zu bearbeiten oder Metadaten hinzuzufügen, gehen Sie zur Registerkarte [Funktionen](https://dashboard.stripe.com/features), klicken Sie auf das Überlaufmenü (⋯) und klicken Sie auf **Funktion bearbeiten**. Sie können den Lookup-Schlüssel einer Funktion nicht bearbeiten, nachdem die Funktion erstellt wurde. ### Eine Funktion aus einem Produkt entfernen Um eine Funktion aus einem Produkt zu entfernen, rufen Sie die Registerkarte [Funktionen](https://dashboard.stripe.com/features) auf und wählen Sie die Funktion aus. Klicken Sie dann auf das Überlaufmenü (⋯) neben dem Produktnamen und klicken Sie auf **Produkt entfernen**. ### Eine Funktion archivieren Um eine Funktion zu archivieren, gehen Sie zur Registerkarte [Funktionen](https://dashboard.stripe.com/features), klicken Sie auf das Überlaufmenü (⋯) und klicken Sie auf **Funktion archivieren**. Bevor Sie eine Funktion archivieren, sollten Sie Folgendes beachten: - Archivierte Funktionen können nicht bearbeitet oder zu neuen Produkten hinzugefügt werden. - Archivierte Funktionen erstellen weiterhin Berechtigungen, wenn sie mit bestehenden Produkten verbunden sind. - Der Lookup-Schlüssel einer archivierten Funktion kann erneut verwendet werden. - Sie können eine Funktion nicht aus dem Archiv entfernen. # API > This is a API for when dashboard-or-api is api. View the full page at https://docs.stripe.com/billing/entitlements?dashboard-or-api=api. ## Loslegen So legen Sie mit Berechtigungen los: - **Funktionen einrichten**: Erstellen Sie jede Funktion in Stripe Billing mit der [Feature API](https://docs.stripe.com/api/entitlements/feature/object.md). 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](https://docs.stripe.com/billing/entitlements.md#webhooks) und verwenden Sie die [List Active Entitlements API](https://docs.stripe.com/api/entitlements/active-entitlement/list.md) 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 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. ```curl curl https://api.stripe.com/v1/entitlements/features \ -u "<>:" \ -d "name=My feature" \ -d lookup_key=myinternalfeaturecode ``` ## Funktionen zu Produkten hinzufügen Weisen Sie Ihre Funktion einem oder mehreren Produkten zu. > Bestehende Abonnements erstellen zu Beginn des nächsten Abrechnungszeitraums aktive Berechtigungen für alle Funktionsänderungen an Produkten. ```curl curl https://api.stripe.com/v1/products/{{PRODUCT_ID}}/features \ -u "<>:" \ -d "entitlement_feature={{ENTITLEMENTSFEATURE_ID}}" ``` Nachdem Sie eine Anfrage zum Verknüpfen Ihrer Funktion mit Ihrem Produkt gesendet haben, erhalten Sie eine Antwort, die in etwa so aussieht: ```json { "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: ```curl curl https://api.stripe.com/v1/products/{{PRODUCT_ID}}/features \ -u "<>:" ``` Und eine Funktion können Sie aus einem bestimmten Produkt entfernen, indem Sie die Verknüpfung der Produktfunktion aufheben: ```curl curl -X DELETE https://api.stripe.com/v1/products/{{PRODUCT_ID}}/features/{{PRODUCTFEATURE_ID}} \ -u "<>:" ``` ## 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. ```curl curl -G https://api.stripe.com/v1/entitlements/active_entitlements \ -u "<>:" \ -d "customer={{CUSTOMER_ID}}" ``` > #### Empfehlung > > Wir empfehlen Ihnen, diese Berechtigungen auch intern anzuwenden, um eine schnellere Lösung zu erzielen. > Ä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.