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
Modèle de protocole contextuel
Sécurité et confidentialité
Sécurité
Robot d'exploration Web Stripebot
Confidentialité
Extensions Stripe
Créer des applications Stripe
Utiliser les applications de Stripe
Partenaires
Partner ecosystem
Certification des partenaires
AccueilRessources pour les développeursChangelogBasil2025-04-30.preview

Ajout d’un mode de facturation pour prendre en charge un meilleur comportement de facturation au prorata des créditsVersion bêta publique

Nouveautés

Le nouveau paramètre billing_mode vous permet d’améliorer la flexibilité du comportement lorsque vous créez des abonnements, des aperçus de facture, des sessions Checkout ou des planifications d’abonnement.

billing_mode=classicbilling_mode=flexible
Les montants des crédits au prorata sont calculés en fonction de la valeur du tarif actuel, des taxes, de la quantité et des dernières réductions utilisées pour le poste d’abonnement. Ce mode de calcul peut entraîner des calculs au prorata inattendus lorsque les taux de taxe d’un client changent en milieu de cycle, les débits au prorata sont désactivés ou des montants complexes sont utilisés sur des bons de réduction.Les crédits au prorata sont calculés sur la base du montant initial précédemment débité à un client. Les calculs au prorata prennent ainsi en compte les taxes, les bons de réduction et les considérations relatives au cycle de facturation. Par exemple, les crédits au prorata refléteront désormais avec précision les taxes en fonction du débit initial (si le taux de taxe a changé en milieu de cycle) et ils ne seront pas émis s’il n’y a pas eu de débit.
subscription.trial_start reste inchangé lorsqu’un abonnement revient à l’état trialing.subscription.trial_start est mis à jour pour refléter la date de début de l’essai la plus récente.
Le billing_cycle_anchor est parfois réinitialisé lors d’autres opérations :
  • billing_cycle_anchor est réinitialisé à la date cancel_at lorsque cancel_at est défini sur une date antérieure au prochain cycle d’abonnement.
  • billing_cycle_anchor est réinitialisé à l’heure actuelle lors du passage d’un abonnement dont tous les tarifs sont à 0 USD à un abonnement dont au moins un tarif est supérieur à 0 USD.
  • billing_cycle_anchor est réinitialisé à l’heure actuelle lorsque vous passez à un tarif avec une fréquence différente.
billing_cycle_anchor n’est pas réinitialisé lors d’autres opérations :
  • billing_cycle_anchor ne change pas lorsque cancel_at est défini sur une date antérieure au prochain cycle d’abonnement.
  • billing_cycle_anchor ne change pas lors du passage d’un abonnement dont tous les tarifs sont à 0 USD à un abonnement dont au moins un tarif est supérieur à 0 USD.
  • billing_cycle_anchor ne change pas lorsque vous passez à un tarif avec une fréquence différente.

La configuration de billing_mode sur flexible présente des limites. En savoir plus sur les limitations et sur la façon dont le mode facturation permet un comportement flexible pour les abonnements.

Impact

Vous pouvez définir billing_mode sur flexible sur les méthodes d’API suivantes permettant de créer un abonnement :

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

Modifications

paramètreModifierRessources ou endpoints
billing_modeAjouté
Checkout.Session#create.subscription_dataInvoice#create_preview.schedule_detailsInvoice#create_preview.subscription_details
 + 7 de plus
Quote#create.subscription_dataQuote.subscription_dataQuotePreviewSubscriptionScheduleSubscription#createSubscriptionSchedule#createSubscriptionScheduleSubscription

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-04-30.preview
  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