Offrez une plus grande flexibilité aux abonnements

Utilisez le mode de facturation flexible pour bénéficier de fonctionnalités améliorées et accéder à des fonctions supplémentaires.

Le mode de facturation flexible offre un comportement de facturation précis et prévisible et des fonctionnalités supplémentaires pour gérer les abonnements. Définir billing_mode=flexible sur un abonnement modifie le comportement des objets Abonnement tout au long de leur cycle de vie et en réponse aux passages à un abonnement supérieur ou inférieur et aux annulations.

Le mode de facturation flexible offre des fonctionnalités de gestion des abonnements différentes de celles du mode de facturation classique. Pour plus d’informations, consultez la section Différences entre les modes de facturation classique et flexible.

Pour utiliser le mode de facturation flexible, votre intégration doit être sur la version 2025-06-30.basil ou une version ultérieure de l’API Stripe. Découvrez comment mettre à niveau votre version de l’API. Vous ne pouvez pas passer du mode de facturation flexible au mode de facturation classique.

Limitations

Le mode de facturation flexible n’est pas compatible avec toutes les fonctionnalités de Stripe Billing. Les fonctionnalités suivantes sont incompatibles et renvoient un code d’état 400 lorsque vous créez et mettez à jour un abonnement avec le mode de facturation flexible activé :

Essais payants
Ancienne facturation à l’usage
Ancienne intégrations avec taxe gérée par des prestataires tiers utilisant pay_immediately=false
Facturation anticipée Version bêta privée
L’utilisation de l’ancien paramètre max_occurences

Configurer le mode de facturation

Créer un nouvel abonnement avec un mode de facturation flexible

Vous pouvez créer et mettre à jour les abonnements avec un mode de facturation flexible dans le Dashboard quelle que soit la version de l’API de votre intégration. Pour modifier entièrement ces abonnements dans l’API Stripe, votre intégration doit se faire sur 2025-06-30.basil ou une version ultérieure. Pour voir sur quelle version vous êtes, rendez-vous dans la aperçu Workbench et regardez la section versions de l’API. De là, cliquez sur Mettre à niveau pour passer à une version plus récente.

Accédez à la page Abonnements du Dashboard.
Sélectionnez +Créer un abonnement.
Faites défiler vers le bas jusqu’à la section Paramètres avancés.
Définissez le Mode de facturation sur Flexible.

Migrer des abonnements existants vers le mode facturation flexible

Vous pouvez migrer vos abonnements en cours en mode de facturation flexible. Les comportements flexibles prennent effet pour toute nouvelle activité sur l’abonnement après migration. Cependant, Stripe ne recalcule aucune ressource créée avant la migration, y compris le prorata en attente Invoice Items.

Pour utiliser le mode de facturation flexible, votre intégration doit reposer sur la version 2025-06-30.basil de l’API Stripe ou une version ultérieure. Pour connaître la version que vous utilisez, accédez à la présentation de Workbench, section Versions de l’API. Ensuite, cliquez sur Mettre à niveau pour passer à une version plus récente.

Sur la page Abonnements du Dashboard, sélectionnez l’abonnement que vous souhaitez migrer.
Sélectionnez Actions, puis Modifier l’abonnement.
Faites défiler vers le bas jusqu’à la section Paramètres avancés.
Définissez le Mode de facturation sur Flexible et sélectionnez Modifier l’abonnement.

Différences entre le mode de facturation classique et celui flexible

Crédits et calculs au prorata

Les prorata de crédit sont émis lorsque les clients passent à un abonnement inférieur ou annulent des postes d’abonnement avant la fin de leur période de facturation. Le mode de facturation flexible calcule les prorata de crédit en fonction du montant initial précédemment débité d’un client.

Pour obtenir un aperçu complet du calcul au prorata du crédit, consultez la page Prorata du crédit.

Classique	Flexible
Lorsqu’une mise à jour d’un abonnement génère un crédit au prorata, les montants du crédit au prorata sont calculés en fonction de la valeur du prix actuel du poste d’abonnement, des taxes, de la quantité et des dernières remises utilisées.	Lorsqu’une mise à jour d’un abonnement génère un crédit au prorata, ces prorata utilisent le montant d’origine débité au lieu des valeurs actuelles de l’abonnement.

Application proportionnelle des réductions pour les calculs au prorata

Nous appliquons des réductions proportionnellement à chaque poste d’abonnement lors du calcul au prorata au lieu de les répartir uniformément. Il en résulte davantage de prorata, en particulier lors de la facturation par poste ou de l’annulation de postes avec des réductions inégalement réparties.

Classique	Flexible
Nous répartissons les remises de manière égale sur tous les postes d’abonnement.	Nous appliquons les remises de manière proportionnelle à chaque poste d’abonnement lors des calculs au prorata.

Tarification à la consommation

Supprimez les postes à montant nul lors de l’ajout de postes à l’usage.

Le mode de facturation flexible ne crée pas de postes à montant nul lorsque vous ajoutez des postes à l’usage à un abonnement. Si la facture est vide en conséquence, nous n’en générons pas.

Par exemple, au moment de l’ajout d’un poste mensuel à l’usage lors de la création ou de la mise à jour d’un abonnement :

Classique	Flexible
Un poste 0 USD est généré sur la facture pour le poste à l’usage. Cela s’applique également lors de la mise à jour d’un abonnement sans cycle pour ajouter un poste à l’usage lors de l’utilisation de `proration_behavior=always_invoice`.	Aucun poste 0 USD n’est ajouté à la facture pour le poste à l’usage. Si la facture qui en résulte ne contient aucun poste, nous n’en générons pas.

Facturez les postes à l’usage en fonction du prix au moment du rapport

Le mode de facturation flexible facture l’usage en fonction du tarif en vigueur au moment de la consommation, plutôt que du tarif le plus récent.

Par exemple, la consommation d’un client est enregistrée comme suit :

Consommation le 5 janvier : 1 000 appels à l’API à 0.1 USD par tranche de 100 appels (tarif A).
Changement de tarif le 15 janviej : le tarif passe à par 100 appels (tarif B).
Consommation le 20 janvier : 500 appels à l’API.

Classique	Flexible
Stripe facture uniquement l’utilisation déclarée depuis le passage au tarif actuel. 500 appels à l’API au tarif B (0.15 USD per 100 calls) = 0.75 USD Montant total de la facture = .	Stripe facture toutes les utilisations de la période en cours au tarif en vigueur au moment de la déclaration. 1 000 appels à l’API au tarif A ( pour 100 appels) = 500 appels à l’API au tarif B (0.15 USD per 100 calls) = 0.75 USD Montant total de la facture = .

Classique

Flexible

Stripe facture uniquement l’utilisation déclarée depuis le passage au tarif actuel.

500 appels à l’API au tarif B (0.15 USD per 100 calls) = 0.75 USD

Montant total de la facture = .

Stripe facture toutes les utilisations de la période en cours au tarif en vigueur au moment de la déclaration.

1 000 appels à l’API au tarif A ( pour 100 appels) =
500 appels à l’API au tarif B (0.15 USD per 100 calls) = 0.75 USD

Montant total de la facture = .

Facturez l’utilisation non facturée lors de la suppression de postes à l’usage

Depending on the value of proration_behavior, flexible billing mode might generate an invoice item for unbilled usage when removing a usage-based subscription item. This applies to removals using the API or during schedule phase transitions that occur mid-period. For phase transitions that coincide with any subscription item current_period_end, an invoice gets created with an invoice line item for the removed usage-based subscription item.

Scenario	Classique	Flexible
Update subscription or schedule using the API	No invoice item or invoice is generated for unbilled usage when removing a usage-based subscription item.	Un poste de facture est généré pour une utilisation non facturée lors de la suppression d’un poste d’abonnement à l’usage.
Schedule phase transition	An invoice (but no invoice item) is generated for unbilled usage when removing a usage-based subscription item.	Depending on the incoming phase’s `proration_behavior`: `create_prorations`: an invoice item is created for unbilled usage when removing a usage-based subscription item. `always_invoice`: an invoice item for unbilled usage is created and immediately invoiced. `none`: no invoice item is created.

Réinitialiser la date de début du cycle de facturation

Le mode de facturation flexible réinitialise uniquement la date de début du cycle de facturation lors des modifications d’abonnement si vous définissez explicitement billing_cycle_anchor sur une valeur autre que unchanged.

Classic	Flexibilité
The `billing_cycle_anchor` is automatically reset to the current date when switching a subscription to a different price with a different recurring interval, from zero-amount prices to non-zero price or moving cancel_at to a date before the next time the subscription renews.	La date `billing_cycle_anchor` n’est jamais réinitialisée automatiquement.

Facturation consolidée pour les transitions de phase de planification d’abonnement avec des postes à l’usage.

Flexible billing mode consistently generates a single invoice when a subscription renews. This change eliminates separate invoices for removed usage-based items and improves billing consistency.

Lorsque votre abonnement avec des postes à l’usage passe d’une phase à l’autre :

Classique	Flexible
Deux factures sont générées.	Une facture consolidée unique est générée. Cette facture inclut à la fois les postes à l’usage et sous licence, applique les réductions de la phase précédente à la facturation à l’usage et utilise les taux de taxe de la phase suivante.

Annulation d’un abonnement planifié

Vous pouvez désactiver les calculs au prorata pour une première période de facturation tronquée (lorsque vous définissez cancel_at à la création) à l’aide du paramètre proration_behavior.

Classique	Flexible
Les calculs au prorata sont appliqués à la première période de facturation.	Les calculs au prorata ne sont pas appliqués à la première période de facturation.

Antidater des abonnements

Lorsque l’antidatation est compatible avec la facturation normale, le mode de facturation flexible crée des postes de facture distincts pour chaque période de facturation dans la plage antidatée. Il aligne également automatiquement la date de début du cycle de facturation sur la backdate_start_date lorsqu’elle n’est pas explicitement définie. L’antidatation n’est pas prise en charge si la facture résultante comporte plus de 250 postes.

For example, a subscription needs to be backdated due to a missed invoice for the past two billing periods. The customer was invoiced for 2 different backdated periods:

Période de facturation 1 (1er mars - 31 mars) :
- Utilisation enregistrée : 100 Go de stockage utilisé.
- Tarif : 10 USD pour 10 Go.

Période de facturation 2 (du 1er avril au 30 avril) :

Utilisation enregistrée : 150 Go de stockage utilisé.
Tarif : 10 USD pour 10 Go.

Le prestataire de services décide d’antidater la facture pour couvrir les deux périodes de facturation : Du 1er mars au 30 avril.

Classic	Flexibilité
Les paiements pour l’ensemble de la période antidatée sont calculés collectivement sous la forme d’un poste unique. Total facturé : 250 Go = 25 x 10 USD = 250 USD Ce montant apparaît sous la forme d’un poste unique sur la facture.	Les plages de temps antidatées sont divisées en sous-poste de facture en fonction des limites de la période de facturation.Total débiter : Période de facturation 1 (mars) : 100 Go = 10 x 10 USD = 100 USD (en tant que poste distinct). Période de facturation 2 (avril) : 150 Go = 15 x 10 USD = 150 USD (en tant que poste distinct).

Périodes d’essai

Modifier la date de début des périodes d’essai en cas d’essais ultérieurs

Le mode de facturation flexible utilise la date de début de période d’essai la plus récente pour les abonnements présentant plusieurs périodes d’essai.

Par exemple, lorsque vous avez :

Période d’essai du 1er janvier au 1er février
Période de facturation normale du 1er février au 1er mars
Période d’essai du 1er mars au 1er avril

Classique	Flexible
Le paramètre `subscription.trial_start` fait toujours référence à la première période d’essai d’un abonnement.	Le paramètre `subscription.trial_start` désigne la date de début de période d’essai la plus récente d’un abonnement.

Conserver la date de fin de l’essai initial lors de l’annulation de l’abonnement

Le mode de facturation flexible préserve la valeur trial_end si vous modifiez la date cancel_at.

Classic	Flexibilité
Si la date `trial_end` est postérieure à `cancel_at`, `trial_end` est défini sur la date d’annulation. Si `cancel_at` est ultérieurement mis à jour ou supprimé, `trial_end` n’est pas défini sur sa valeur d’origine.	La planification d’une résiliation d’abonnement à l’aide de `cancel_at` ne modifie plus la date `trial_end`. Cela permet de s’assurer que les essais conservent la durée prévue, quelles que soient les modifications apportées à la date d’annulation.

Standardiser la description des postes à période d’essai

Le mode de facturation flexible utilise un format de description cohérent pour les postes à l’usage et sous licence pendant les périodes d’essai.

Par exemple, lorsque vous avez un abonnement café mensuel (sous licence) et un abonnement alpaca_ai_tokens (à l’usage), la description de l’abonnement s’affiche comme suit :

Classique Flexible

Classique	Flexible
Les postes sous licence utilisent le modèle `Période d'essai pour {product name}`, tandis que les postes à l’usage utilisent `{quantity} x {product name} (essai gratuit)`. Pour les articles à quantité prédéterminée : `Trial period for monthly coffee subscription` Pour les postes facturés à l’usage : `10 x monthly alpaca_ai_tokens (Free trial)`	Le même format, `Free trial for {quantity} x {product name}`, s’applique à tous les types de postes, ce qui permet une présentation plus uniforme des informations relatives aux périodes d’essai. Ces descriptions sont également localisées. Pour les articles à quantité prédéterminée : `Free trial for 1 x monthly coffee subscription` Pour les postes facturés à l’usage : `Free trial for 10 x monthly alpaca_ai_tokens subscription`

Les postes sous licence utilisent le modèle Période d'essai pour {product name}, tandis que les postes à l’usage utilisent {quantity} x {product name} (essai gratuit).

Pour les articles à quantité prédéterminée :
- Trial period for monthly coffee subscription
Pour les postes facturés à l’usage :
- 10 x monthly alpaca_ai_tokens (Free trial)

Le même format, Free trial for {quantity} x {product name}, s’applique à tous les types de postes, ce qui permet une présentation plus uniforme des informations relatives aux périodes d’essai. Ces descriptions sont également localisées.

Pour les articles à quantité prédéterminée :
- Free trial for 1 x monthly coffee subscription
Pour les postes facturés à l’usage :
- Free trial for 10 x monthly alpaca_ai_tokens subscription

Refacturation des postes d’essai

Le mode de facturation flexible ne génère des postes que pour les modifications apportées au cours d’une période d’essai. Les postes existants non modifiés ne sont pas refacturés.

Par exemple, lorsque vous effectuez une mise à jour pour ajouter un nouveau poste d’essai price_b à un abonnement en période d’essai au tarif price_a :

Classic	Flexibilité
Les modifications apportées au cours d’une période d’essai soit ne génèrent aucune facture, soit génèrent une facture qui reprend l’intégralité de l’état de l’abonnement.	Les modifications apportées au cours d’une période d’essai donnent systématiquement lieu à des postes de facture comparables aux modifications effectuées en dehors d’une période d’essai. Par exemple, si un nouveau tarif est ajouté à un abonnement, un poste représentant cet ajout est également ajouté.

Postes de facture en attente

Inclure systématiquement les postes de facture en attente

Le mode de facturation flexible inclut tous les postes de facture en attente disponibles dans les factures générées par une réinitialisation du début du cycle de facturation, où proration_behavior = always_invoice.

Classique	Flexible
Les factures de réinitialisation du début du cycle de facturation comprennent des postes en attente, ce qui n’est pas le cas des factures `always_invoice`.	Les postes de facture en attente sont toujours inclus dans toutes les factures générées par un abonnement.

Périodes mixtes sur un même abonnement Version bêta privée

Le mode de facturation flexible vous permet d’accéder aux abonnements à périodes mixtes. Vous pouvez facturer plusieurs tarifs récurrents à différentes périodes sur un même abonnement en utilisant des abonnements à périodes mixtes. Cela vous permet de combiner différentes structures tarifaires au sein d’un même abonnement.

Classique	Flexible
Non pris en charge. Tous les postes d’un abonnement doivent présenter des tarifs avec la même période et le même nombre d’intervalles.	Créez des abonnements à périodes mixtes, pour lesquels les postes d’un abonnement peuvent avoir des tarifs récurrents avec des périodes ou des nombres d’intervalles différents. Par exemple, un tarif mensuel et un tarif annuel peuvent coexister sur un même abonnement.