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é
Confidentialité
Extensions Stripe
Créer des applications Stripe
Utiliser les applications de Stripe
Partenaires
Partner ecosystem
Certification des partenaires
AccueilRessources pour les développeursChangelogBasil2025-03-31.basil

Les ressources de facturation spécifient désormais comment elles ont été généréesModifications majeures

Nouveautés

Nous introduisons un nouveau champ parent pour les factures, les postes de facture et les sous-postes de facture. Le champ parent vous permet d’afficher les détails de l’objet d’origine ayant généré les invoice, invoice item ou invoice line item (tel qu’un abonnement, un devis ou autre). Il remplace les champs de premier niveau que nous utilisions précédemment pour référencer ces objets.

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

  • Sur l’objet Invoice, nous avons supprimé les champs quote, subscription, subscription_details et subscription_proration_date.
  • Sur l’objet Invoice Item, nous avons supprimé les champs subscription_item et subscription.
  • Sur l’objet Invoice Line Item, nous avons supprimé les champs type, subscription, subscription_item, invoice_item, proration et proration_details.

Impact

Remplacez les références de champ sur les objets de facturation par leur nouvel emplacement dans le champ parent.

Sur les objets Invoice :

  • Utilisez invoice.parent.subscription_details.subscription (vérifiez que invoice.parent.type est subscription_details) au lieu de invoice.subscription.
  • Cela s’applique également aux éléments suivants :
    • quote
    • subscription_details
    • subscription_proration_date

Sur les objets Invoice Item :

  • Utilisez invoiceitem.parent.subscription_details.subscription (vérifiez que invoiceitem.parent.type est subscription_details) au lieu de invoice_item.subscription
  • Cela concerne également le champ subscription_item

Sur les objets Invoice Line Item :

  • Utilisez line_item.parent.subscription_item_details.subscription_item (vérifiez que line_item.parent.type est subscription_item_details) au lieu de line_item.subscription_item.
  • Cela s’applique également aux éléments suivants :
    • subscription
    • invoice_item
    • proration
    • proration_details

Modifications

paramètresModifierRessources ou endpoints
subscription_itemsubscriptionSupprimé
InvoiceItem
quotesubscription_detailssubscriptionsubscription_proration_dateSupprimé
Invoice
invoice_itemproration_detailsprorationsubscriptionsubscription_itemtypeSupprimé
InvoiceLineItem
parentAjouté
InvoiceItemInvoiceInvoiceLineItem

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

  • Ajout des périodes de facturation au niveau des articles d’abonnement et suppression des périodes au niveau de l’abonnement
  • Ajout de la prise en charge de la dernière formule d’agrégation sur les dispositifs de mesure
  • Ajout de nouveaux types d’événements de webhook pour les compteurs de facturation
  • Ajout de nouveaux types d’événements de webhook pour les crédits de facturation
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