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 leur consommation en évaluant l’utilisation sur une base hebdomadaire (ce qui correspond à la période de service). Toutefois, pour réduire les coûts administratifs, vous pouvez générer des factures uniquement sur une base mensuelle (ce qui correspond à la cadence 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 votre flux de 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 compteur du nouveau tarif est facturée en fonction de ce tarif et apparaît sur la prochaine facture. 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 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-07-30.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 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-07-30.preview"