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
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-03-31.basil

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 de nouveaux types d'objets de tarificationModifications majeures

Nouveautés

Nous introduisons un nouveau concept de pricing polymorphe sur les postes de facture et les sous-postes de facture. Il contient toutes les données relatives aux tarifs et unifie la structure des objets de tarification (prix et offre) pour se préparer à l’ajout de nouveaux types d’objets de tarification. Nous déplaçons également les données unitaires de montant dans les pricing.

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

  • Les champs price et plan ne sont plus disponibles sur les postes de facture et les sous-postes de facture.
  • Déplacez unit_amount et unit_amount_decimal vers le nouveau concept pricing pour les postes de facture et les sous-postes de facture.

Impact

Remplacez toutes les références à price ou plan sur les postes de facture ou les sous-postes de facture par le champ pricing :

  • Au lieu de invoice_item.price.id, utilisez invoice_item.pricing.price_details.price après avoir vérifié que invoice_item.pricing.type est défini sur price_details
  • Lors de la création ou de la mise à jour de postes de facture, utilisez le paramètre pricing au lieu de price (par exemple, définissez pricing.price au lieu de transmettre le paramètre price)
  • Pour les montants unitaires, utilisez pricing.unit_amount_decimal au lieu de unit_amount ou unit_amount_decimal
  • Lors de la création ou de la mise à jour de postes de facture, utilisez le paramètre unit_amount_decimal au lieu de unit_amount

Modifications

paramètresModifierRessources ou endpoints
planpriceunit_amount_decimalunit_amountSupprimé
InvoiceItem
planpriceSupprimé
InvoiceLineItem
pricingAjouté
Invoice#add_lines.lines[]Invoice#update_lines.lines[]InvoiceItem#create
 + 4 de plus
InvoiceItem#updateInvoiceLineItem#updateInvoiceItemInvoiceLineItem
priceSupprimé
Invoice#add_lines.lines[]Invoice#update_lines.lines[]InvoiceItem#create
 + 4 de plus
InvoiceItem#updateInvoiceItemInvoiceLineItem#updateInvoiceLineItem
unit_amountSupprimé
InvoiceItem#createInvoiceItem#updateInvoiceItem

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-03-31.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.

Changements connexes

  • Remplacement des propriétés fiscales de niveau supérieur par une modélisation fiscale améliorée sur les factures, les sous-postes de facture et les postes d’avoir
  • Ajout de la prise en charge des paiements multiples (partiels) sur les factures
  • Ajoute la subdivision territoriale et le motif d’assujettissement à la taxe aux montants de taxe manuels sur les factures
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