Droits d'accès

Déterminez quand vous pouvez accorder à vos clients l'accès aux fonctionnalités de vos produits et quand vous pouvez le révoquer.

Les droits d’accès vous permettent de mapper les fonctionnalités de votre service interne aux produits Stripe. Une fois que vous avez mappé vos fonctionnalités, Stripe vous indique quand fournir ou retirer l’accès des clients (en fonction de leur état d’abonnement), ainsi que les fonctionnalités concernées en fonction de vos choix de mappage.

Utilisez les droits d’accès pour :

Lancer, modifier et faire des essais avec vos tarifs sans avoir à modifier votre code base
Accorder, révoquer et gérer l’accès de vos clients aux fonctionnalités
Simplifier votre intégration de facturation

Démonstration de l’API Stripe Billing Entitlements

Avant de commencer

Dans ce guide, nous partons du principe que vous savez déjà créer des abonnements et des clients dans Stripe.

Démarrer

Pour démarrer avec les droits d’accès :

Configurez vos fonctionnalités : créez chaque fonctionnalité dans Stripe Billing à l’aide de l’API Feature. Voici quelques exemples de fonctionnalités que vous pouvez inclure :
- Accès à l’API
- Assistant IA
- Assistance Premium
- Reporting avancé
- Conservation prolongée des données
Ajoutez vos fonctionnalités à des produits : associez les fonctionnalités aux produits Stripe concernés. Vous pouvez ajouter une même fonctionnalité à plusieurs produits.
Obtenez les droits d’accès actifs des clients : lorsque les clients s’abonnent à vos produits, Stripe Billing leur donne le droit d’accéder aux fonctionnalités de ces produits. Écoutez le webhook Active Entitlement Summary et utilisez l’API List Active Entitlements pour un client donné afin d’exécuter votre processus de mise en service des fonctionnalités.

Diagramme illustrant les droits d'accès et leur lien avec un client, et les fonctionnalités du produit

Configurer vos fonctionnalités

Fournissez un nom et une lookup_key unique pour chaque caractéristique que vous créez. La lookup_key étant propre à chaque fonctionnalité, vous ne pouvez pas la réutiliser pour d’autres fonctionnalités.

Ajouter vos fonctionnalités à des produits

Affectez votre fonctionnalité à un ou plusieurs produits.

Remarque

Les abonnements existants créeront des droits actifs pour toute modification de fonctionnalité produit au début de la prochaine période de facturation.

Lorsque vous envoyez une requête pour rattacher votre fonctionnalité à votre produit, vous recevez une réponse de ce type :

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

Répertoriez les fonctionnalités rattachées à un produit en parcourant la liste des fonctionnalités :

Vous pouvez également supprimer une fonctionnalité d’un produit spécifique en supprimant la partie de code correspondant à cette fonctionnalité :

Obtenir les droits d'accès actifs des clients

Au cours du cycle de vie de l’abonnement d’un client, de son activation aux passages à une offre supérieure ou inférieure, Stripe modifie les droits du client en fonction des fonctionnalités que vous avez mappées.

Lorsque l’abonnement d’un client est activé pour la première fois, Stripe lui accorde des droits d’accès pour les fonctionnalités auxquelles il est abonné.

Tant qu’un client dispose d’un abonnement actif pour une fonctionnalité, il conserve un droit actif. Assurez-vous de fournir un accès à votre système à tous les utilisateurs ayant droit à cette fonctionnalité.

Écouter les événements de webhook

Si vos webhooks sont activés, nous envoyons l’événement webhook suivant pour vous informer de tout changement dans les droits d’un client.

Limite des droits d'accès disponibles dans le webhook récapitulatif

La propriété active_entitlements du récapitulatif des droits d’accès ne contient pas plus de 10 droits. Nous fournissons également une URL pour récupérer la liste complète et paginée des droits du client.

Événement	Description
`entitlements.active_entitlement_summary.updated`	Se produit lorsque les droits d’accès actifs d’un client sont modifiés.

Récupérer la liste de tous les droits d’accès actifs pour un client

Le endpoint de la liste renvoie une liste paginée de tous les droits actifs d’un client.

Recommandation

Nous vous recommandons de conserver ces droits d’accès en interne pour une résolution plus rapide.

Remarque

Les modifications des tarifs, offres et droits des abonnements peuvent être soumises à certaines obligations légales. Consultez votre conseiller juridique pour obtenir des conseils spécifiques à votre entreprise.