Accéder directement au contenu
Créez un compte
ou
connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compte
Connectez-vous
Démarrer
Paiements
Revenus
Plateformes et places de marché
Gestion de fonds
Ressources pour les développeurs
Aperçu
Gestion des versions
Journal des modifications
    Présentation
    Basil
    Acacia
    Versions précédentes
Mettre à niveau votre version de l'API
Actualiser votre version du SDK
Essentials
SDK
API
Tests
CLI Stripe
Exemples de projets
Outils
Workbench
Dashboard des développeurs
Shell Stripe
Stripe pour Visual Studio Code
Fonctionnalités
Workflows
Destinations d'événements
Alertes d'intégrité de StripeChargements de fichiers
Solutions d'IA
Boîte à outils des agents
Sécurité et confidentialité
Sécurité
Confidentialité
Extensions Stripe
Build Stripe apps
Use apps from Stripe
Partenaires
Partner ecosystem
Certification des partenaires
AccueilRessources pour les développeursChangelogBasil2025-06-30.basil

Ajout d’un mode facturation pour permettre un meilleur comportement et une plus grande flexibilité des abonnements

Nouveautés

Nous introduisons un nouveau paramètre billing_mode, qui permet un comportement d’abonnement plus flexible. Vous pouvez l’activer en définissant billing_mode[type]=flexible lorsque vous créez des abonnements, des aperçus de factures, des sessions Checkout, des devis ou des planifications d’abonnement. Le mode par défaut, classic, préserve le comportement existant. Vous pouvez également migrer des abonnements existants à l’aide du nouvel endpoint de migration en mode facturation.

Nous appellerons désormais le comportement actuel de facturation classic.

Consultez ci-dessous le récapitulatif des nouveaux comportements liés au mode facturation flexible. En savoir plus sur les différences entre les modes de facturation classique et flexible.

Zone d’impactNouveaux comportements

Calcul au prorata

Calcul précis du crédit au prorata. Le mode de facturation flexible utilise systématiquement le montant débité d’origine, en tenant compte avec précision de l’historique des taxes, des remises et des cycles de facturation.

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

Tarifs à la consommation

Suppression des postes à montant nul lors de l’ajout de postes facturés à la consommation. Le mode de facturation flexible ne crée pas de postes à montant nul lorsque vous ajoutez des postes à la consommation à un abonnement. Par conséquent, si la facture est vide, nous n’en générons pas.

Facturation à la consommation sur la base du tarif au moment où elle est signalée. Le mode de facturation flexible facture l’utilisation sur la base du tarif au moment où vous la signalez. Si le tarif d’un poste facturé à la consommation change au cours d’une période, seule l’utilisation mesurée après le changement de prix est facturée au nouveau tarif.

Facture l’utilisation non facturée lors de la suppression de postes facturés à la consommation. Le mode de facturation flexible génère un poste de facture pour l’utilisation non facturée lorsque vous supprimez un poste d’abonnement facturé à la consommation. Cela s’applique aux prélèvements à l’aide de l’API ou lors des transitions de phase de planification.

Consolide les factures pour les transitions de phase avec les postes facturés à la consommation. Le mode de facturation flexible génère systématiquement une seule facture lors des cycles d’abonnement, ce qui élimine la nécessité de créer des factures distinctes pour les postes facturés à la consommation supprimés.

Date de début du cycle de facturationÉlimine les réinitialisations implicites du début du cycle de facturation. Avec le mode de facturation flexible, le billing_cycle_anchor reste inchangé pendant les opérations qui l’ont précédemment réinitialisé, telles que la définition d’une date cancel_at ou le passage à un tarif non nul.
Annulation programméeComportement de calcul au prorata configurable pour cancel_at. Vous pouvez désormais désactiver les calculs au prorata pour une première période d’abonnement tronquée (lorsque vous définissez cancel_at à la création) à l’aide du paramètre proration_behavior.
AntidatageDivise la période antidatée en plusieurs postes de facture. Le mode de facturation flexible crée des postes de facture distincts pour chaque période de facturation dans la plage antidatée. La date de début du cycle de facturation s’aligne automatiquement sur la backdate_start_date si vous ne la définissez pas explicitement.

Périodes d’essai

Met à jour la date de début de l’essai pour les essais suivants. Lorsque vous ajoutez une deuxième période d’essai à un abonnement d’essai, le mode de facturation flexible utilise la date de début de l’essai la plus récente.

Préserve la date de fin initiale de l’essai lorsque la date d’annulation change. Le mode de facturation flexible préserve la date trial_end si vous modifiez la date cancel_at pour qu’elle se produise avant la fin de la période d’essai.

Standardise la description des postes de la période d’essai. Avec le mode de facturation flexible, les articles facturés à la consommation comme les articles sous licence utilisent un format de description cohérent (« Essai gratuit pour {quantity} x {product name} ») pour une présentation plus uniforme des informations relatives à l’essai.

Génère des postes pour les modifications apportées au cours d’une période d’essai. En mode de facturation flexible, les postes qui n’ont pas été modifiés ne sont pas refacturés. Cela garantit que les clients ne sont facturés que pour les réajustements qu’ils effectuent au cours de leur essai.

Postes de facture en attenteInclut systématiquement les postes de facture en attente. Tous les postes de facture en attente disponibles sont désormais inclus lors de la génération de factures pour mises à jour. Auparavant, cela dépendait de la raison spécifique de la mise à jour de la facture.

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

  • Facturation anticipée Version bêta
  • Seuils de facturation
  • Ancienne facturation à l’usage
  • Les anciennes intégrations fiscales tierces utilisant pay_immediately=false (par exemple, Avalara)
  • L’ancien paramètre max_occurences
  • retry_settings spécifique à l’abonnement

Impact

Par défaut, cette mise à jour n’a aucune incidence sur les abonnements nouveaux ou existants. Vous pouvez activer cette option en définissant billing_mode[type]=flexible sur les méthodes d’API suivantes :

  • Créer un abonnement
  • Créer un aperçu de facture
  • Créer une session Checkout
  • Créer une planification d’abonnement
  • Créer un devis

Vous pouvez migrer des abonnements existants du mode classique au mode flexible en transmettant billing_mode[type]=flexible dans l`endpoint de migration du mode facturation. Le passage au mode de facturation flexible est un processus à sens unique : il n’est plus possible de revenir au mode classique après la migration.

Modifications

endpoint Modifierressource
migrateAjouté
Subscription
paramètreModifierRessources ou endpoints
billing_modeAjouté
Checkout.Session#create.subscription_dataInvoice#create_preview.schedule_detailsInvoice#create_preview.subscription_details
 + 6 de plus
Quote#create.subscription_dataQuote.subscription_dataSubscriptionSubscription#createSubscriptionScheduleSubscriptionSchedule#create

Mise à niveau

  1. Consultez la version actuelle de votre API dans Workbench.
  2. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API.
    • Si vous n’utilisez pas de SDK, mettez à jour vos requêtes API pour inclure la version Stripe : 2025-06-30.basil
  3. Mettez à niveau la version de l’API utilisée pour les endpoints de webhook.
  4. Testez votre intégration avec la nouvelle version.
  5. Si vous utilisez Connect, testez votre intégration Connect.
  6. Effectuez la mise à niveau dans Workbench. Vous pourrez revenir à la version précédente pendant 72 heures.

En savoir plus sur les mises à niveau de l’API Stripe.

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc