Gérer les grilles tarifairesVersion bêta privée

Ce guide explique comment mettre à jour et maintenir une configuration de facturation à l’usage qui utilise des grilles tarifaires, y compris comment créer des fréquences de facturation et des intervalles de service distincts, présenter de nouveaux services à tous les abonnés et configurer des versions tarifaires par cohorte d’utilisateurs.

Configurer une fréquence de facturation et un intervalle de service distincts

Vous pouvez fournir à vos clients des informations plus fréquentes sur l’utilisation en calculant l’utilisation chaque semaine (il s’agit de la période de service). Toutefois, pour réduire les frais administratifs, vous pouvez choisir de générer des factures une fois par mois (il s’agit de la fréquence de facturation).

En définissant séparément l’intervalle de service et la fréquence de facturation, vous avez la possibilité d’agréger l’utilisation et de fournir l’accès à une fréquence donnée (par exemple, hebdomadaire), mais de facturer les clients à une autre fréquence (par exemple, mensuellement). Cela peut vous aider à optimiser vos besoins en trésorerie.

Déployer de nouveaux services pour tous les abonnés sans rédiger une seule ligne de code

Si vous lancez une nouvelle fonctionnalité avec une nouvelle tarification, vous pouvez appliquer cette tarification à tous vos abonnés en ajoutant un nouveau tarif à la grille tarifaire. Tous les abonnés de la version en production ont accès au nouveau service que vous avez ajouté, et le nouveau tarif s’applique immédiatement.

Lorsque vous ajoutez un nouveau tarif à votre grille tarifaire, il est immédiatement disponible pour tous les abonnés de cette version. Toute utilisation communiquée au dispositif de mesure du nouveau tarif est facturée au tarif en question, même si vous l’ajoutez au milieu d’un cycle de facturation. Cela vous permet de lancer rapidement de nouveaux services facturables (p. ex. un nouveau modèle d’IA) sans écrire de code.

Pour ajouter de nouveaux tarifs à votre grille tarifaire existante via le Dashboard :

1. Accédez à la page Grilles tarifaires.
2. Sélectionnez une grille tarifaire, puis cliquez sur Modifier la grille tarifaire.
3. Cliquez sur pour ajouter un nouveau tarif.

Configurer différentes versions de tarification par cohorte d’utilisateurs

Les grilles tarifaires utilisent la gestion des versions pour vous offrir une gestion flexible des tarifs. Lorsque vous créez une grille tarifaire, une version de production initiale est automatiquement définie par défaut pour les nouveaux abonnés. L’ajout de nouveaux tarifs à une grille tarifaire ne crée pas une nouvelle version. Seule la modification ou la suppression d’un prix existant crée une nouvelle version. La version d’origine reste en production jusqu’à ce que vous changiez de version de production.

Pour proposer des tarifs différents à différentes cohortes de clients :

1. Abonnz de nouveaux clients à la version de production actuelle (par défaut) d’une grille tarifaire.
2. Créez différentes versions pour différents segments de clientèle.
3. Abonnez des clients spécifiques à des versions antérieures.

Lorsque vous créez un abonnement avec une grille tarifaire, vous pouvez spécifier la version à utiliser :

curl -X POST https://api.stripe.com/v2/billing/rate_card_subscriptions \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-05-28.preview" \
  --json '{
    "rate_card": "rcd_A",
    "billing_cadence": "bc_1",
    "rate_card_version": "rcdv_123"
  }'

Si vous ne spécifiez pas de version, Stripe utilise automatiquement la version active actuelle.

Migrer les clients vers des grilles tarifaires nouvelles ou mises à jour

Pour modifier la version d’un abonné existant, vous devez résilier son abonnement avec grille tarifaire et en créer un nouveau avec la nouvelle version. Vous pouvez migrer les clients existants vers une nouvelle grille tarifaire ou vers une nouvelle version d’une grille tarifaire. Pour ce faire, annulez les abonnements actuels qui utilisent l’ancienne grille tarifaire ou l’ancienne version de la grille tarifaire. Ensuite, abonnez vos clients à la nouvelle grille tarifaire ou à sa nouvelle version.

Résilier des abonnements avec grille tarifaire

Pour résilier un abonnement avec grille tarifaire :

• Dans le Dashboard, accédez à la page Abonnements avec grille tarifaire et sélectionnez celui que vous souhaitez résilier. Cliquez sur le menu de débordement () situé à droite de l’abonnement et sélectionnez Résilier.
• Pour utiliser l’API, faites une requête à l’endpoint Résilier un abonnement avec grille tarifaire :

curl -X POST https://api.stripe.com/v2/billing/rate_card_subscriptions/{{RATE_CARD_SUBSCRIPTION_ID}}/cancel \
  -H "Authorization: Bearer 
{{YOUR_API_KEY}}
" \
  -H "Stripe-Version: 2025-05-28.preview"