Offrez une plus grande flexibilité aux abonnements

Vous pouvez définir votre mode de facturation préféré pour gérer vos factures et vos abonnements en fonction des paramètres de votre entreprise. Vous pouvez configurer chaque abonnement pour qu’il utilise l’un des deux modes de facturation suivants :

• Flexible Recommended : offre un comportement de facturation précis et prévisible ainsi que de nouvelles fonctionnalités. Pour accéder à ces améliorations, qui ne sont disponibles qu’en mode de facturation flexible, vous devez créer de nouveaux abonnements en mode de facturation flexible ou migrer vos abonnements existants.
• Classique : utilise le comportement d’abonnement existant de Stripe. Ce paramètre est conservé pour une compatibilité ascendante avec les anciennes intégrations.

Vous pouvez en savoir plus sur les différences détaillées entre le mode de facturation classique et le mode de facturation flexible et sur la manière de choisir le mode de facturation qui vous convient le mieux.

Pourquoi opter pour un mode de facturation flexible

Le mode de facturation flexible permet une facturation plus précise pour les prorata, la tarification basée sur l’utilisation, la facturation flexible et les paramètres d’essai. Il débloque également de nouvelles fonctionnalités, telles que les intervalles mixtes sur le même abonnement. Ces améliorations ne sont disponibles qu’en mode de facturation flexible, c’est pourquoi nous vous recommandons de créer de nouveaux abonnements en mode de facturation flexible et de migrer vos abonnements existants.

Nous recommandons aux nouveaux utilisateurs de Billing d’utiliser le mode de facturation flexible pour les abonnements et les factures, bien que nous ne l’exigions pas.

Pour les utilisateurs existants, votre mode de facturation par défaut est conservé en tant que classique afin de maintenir la compatibilité ascendante avec votre intégration actuelle. Cependant, nous vous recommandons de migrer vers le mode de facturation flexible pour profiter des dernières fonctionnalités et améliorations en matière de facturation. En savoir plus sur les différences entre le mode de facturation classique et le mode de facturation flexible.

Démarrez avec un mode de facturation flexible

Vous pouvez définir ou mettre à jour le mode de facturation via l’API ou le Dashboard lorsque vous créez ou migrez des abonnements. Nous appliquerons un mode de facturation par défaut si vous n’en spécifiez aucun.

• Si vous créez ou mettez à jour un abonnement via l’API, la valeur par défaut du mode de facturation dépend de votre version d’intégration de l’API.
• If you create or update subscriptions through the Dashboard (including Payment Links and Pricing Tables), the default value depends on the billing mode default setting you configure in Settings > Billing > Subscriptions and emails.

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. Découvrez comment passer à une version supérieure de l’API.

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

Dashboard

API

Vous pouvez créer un abonnement en mode de facturation flexible ou mettre à jour un abonnement en mode de facturation classique pour qu’il soit flexible via 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 être en version 2025-06-30.basil ou plus récente. Pour savoir sur quelle version vous êtes, accédez à l’aperçu de Workbench et regardez la section des versions de l’API. Cliquez ensuite sur Upgrade pour passer à une version plus récente.

Pour créer un abonnement en mode facturation flexible via l’éditeur d’abonnements, suivez les étapes ci-dessous :

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

La valeur par défaut du mode de facturation dépend des paramètres de votre compte. Vous pouvez personnaliser les options de mode de facturation affichées et la sélection par défaut dans la rubrique Paramètres avancés en configurant le paramètre par défaut du mode de facturation sous Paramètres > Facturation > Abonnements et e-mails. Dans l’éditeur d’abonnement, vous pouvez choisir d’afficher les options de mode de facturation parmi les suivantes :

• Classique : les deux modes de facturation, flexible et classique, sont affichés, le mode classique étant sélectionné par défaut. Cette option est recommandée si votre intégration dépend du mode de facturation classique et que vous ne pouvez pas encore passer à la facturation flexible.
• Flexible : les deux modes de facturation, flexible et classique, sont affichés, le mode flexible étant sélectionné par défaut. Cette option est recommandée si vous passez activement au mode de facturation flexible.
• Mode flexible et mode classique masqué : seul le mode de facturation flexible s’affiche dans l’éditeur d’abonnement. Cette option est recommandée pour les nouveaux utilisateurs de Stripe Billing et pour les utilisateurs existants qui utilisent exclusivement le mode de facturation flexible.

Paramètres du mode de facturation du Dashboard

Le paramètre par défaut du mode de facturation détermine également le mode de facturation des abonnements créés par les Payment Links et les Pricing Tables générés par le Dashboard. Par exemple, si vous définissez le mode de facturation par défaut sur flexible et que vous créez ensuite un Payment Link dans le Dashboard, tout abonnement généré à partir de ce Payment Link utilise le mode de facturation flexible.

Le paramètre par défaut du mode de facturation s’applique uniquement aux nouveaux abonnements créés dans le Dashboard. Il n’affecte pas les abonnements créés à l’aide de l’API ou les abonnements migrés en mode 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.

Mode de facturation et planification d’abonnement

Lorsque vous créez une planification d’abonnement à partir d’un abonnement existant, ne définissez pas le billing_mode si l’abonnement en possède déjà un. La planification d’abonnement hérite automatiquement le billing_mode de l’abonnement d’origine. Si vous définissez le billing_mode lors de l’utilisation de from_subscription, Stripe renvoie une erreur. Si vous avez besoin d’un autre billing_mode, créez un nouvel abonnement.

Afficher les remises au prorata détaillées

Si vous utilisez le mode d’abonnement flexible, vous pouvez définir votre comportement préféré pour réductions au prorata sur les factures et les postes de facture :

• Détaillé Recommended : permet d’afficher les calculs au prorata avec les montants bruts et les montants de réduction précis, conformément aux calculs sans prorata, et ce, dans les factures et les postes de facture.
• Inclusif : utilise le comportement d’affichage de facture au prorata existant de Stripe, avec le montant net et des montants de réduction monétaire nuls. Ce paramètre est conservé pour la rétrocompatibilité avec les anciennes intégrations.

En savoir plus sur les différences entre le mode détaillé et le mode inclusif.

Pour activer les remises au prorata détaillées, vous devez mettre à niveau votre version de l’API vers 2025-06-30.basil ou une version ultérieure.

Créez ou migrez un abonnement afin de définir proration_discounts sur itemized.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-06-30.basil" \
  -d "items[0][price]"=
"{{PRICE_ID}}" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "billing_mode[type]"=flexible \
  -d "billing_mode[flexible][proration_discounts]"=itemized \
  -d payment_behavior=default_incomplete \
  -d "payment_settings[save_default_payment_method]"=on_subscription

L’exemple de code ci-dessus renvoie la réponse suivante :

{
  "id": "sub_JgRjFjhKbtD2qz",
  "object": "subscription",
  "billing_mode": {
    "flexible": {
      "proration_discounts": "itemized"
    },
    "type": "flexible",
    "updated_at": 1751071020
  },