Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Demander à l'assistant IA
Créez un compteConnectez-vous
Démarrer
Paiements
Revenus
Plateformes et marketplaces
Gestion de fonds
Ressources pour les développeurs
API et SDKAide
Aperçu
Gestion des versions
Journal des modifications
    Présentation
    Clover
    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
Dashboard Stripe
Workbench
Dashboard des développeurs
Stripe pour Visual Studio Code
Terraform
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 contextuelCréer des flux de facturation SaaS avec l’IA agentique
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
États-Unis
Français (France)
AccueilRessources pour les développeursChangelogBasil2025-06-30.preview

Remarque

Cette page n'est pas encore disponible dans cette langue. Nous faisons tout notre possible pour proposer notre documentation dans davantage de langues et nous vous fournirons la version traduite dès qu'elle sera disponible.

Ajout de la prise en charge des objets polymorphes pour le mode facturationModifications majeures

Nouveautés

Nous avons harmonisé le format du paramètre et du champ billing_mode sur tous les endpoints de facturation. Le paramètre billing_mode utilise désormais un format d’objet cohérent avec le champ type, qui remplace l’ancien format de chaîne. Nous avons également consolidé le champ billing_mode_details dans l’objet principal billing_mode.

Pourquoi s’agit-il d’une modification majeure ?

Le paramètre et le champ billing_mode n’acceptent plus de valeur de chaîne (classic ou flexible), mais exigent désormais un objet avec un champ type (par exemple, {type: 'flexible'}). De plus, le champ distinct billing_mode_details a été supprimé, et sa propriété updated_at est désormais incluse directement dans l’objet billing_mode.

Impact

Vous devez mettre à jour votre intégration si vous utilisez actuellement le paramètre billing_mode ou si vous accédez au champ billing_mode des réponses API.

Avant :

{ "billing_mode": "flexible", "billing_mode_details": { "updated_at": 1234567890 } }

Après :

{ "billing_mode": { "type": "flexible", "updated_at": 1234567890 } }

Cette modification affecte les endpoints et ressources d’API suivants :

  • Créer des abonnements
  • Créer des planifications d’abonnement
  • Sessions Checkout
  • Devis
  • Créer une facture préliminaire

Modifications

paramètreModifierRessources ou endpoints
billing_mode_detailsSupprimé
Subscription
champsModifierDe → à
Checkout.Session#create.subscription_data.billing_modeInvoice#create_preview.schedule_details.billing_modeInvoice#create_preview.subscription_details.billing_modeQuote#create.subscription_data.billing_modeQuote.subscription_data.billing_modeSubscription#create.billing_modeSubscriptionSchedule#create.billing_modeModifié
enum('classic'|'flexible') → billing_mode
Quote.subscription_data.billing_modeQuotePreviewSubscriptionSchedule.billing_modeSubscription.billing_modeSubscriptionSchedule.billing_modeModifié
optional → required
QuotePreviewSubscriptionSchedule.billing_modeSubscription.billing_modeSubscriptionSchedule.billing_modeModifié
enum('classic'|'flexible') → SubscriptionsResourceBillingMode
Subscription#migrate.billing_modeModifié
literal('flexible') → billing_mode_migrate

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.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.
  • Consultez notre log des modifications.
  • Des questions ? Contactez l'équipe commerciale.
  • LLM ? Lire llms.txt.
  • Propulsé par Markdoc