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
Outils de développement
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
Outils de développement
SDK
API
Tests
Workbench
Destinations d'événements
Workflows
CLI Stripe
Shell Stripe
Dashboard des développeurs
Boîte à outils des agents
Intégrer des LLMStripe pour Visual Studio CodeAlertes d'intégrité de StripeChargements de fichiers
Sécurité et confidentialité
Sécurité
Confidentialité
Extensions Stripe
Stripe Apps
Connecteurs Stripe
Partenaires
Partner ecosystem
Certification des partenaires
AccueilOutils de développementChangelogBasil2025-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.

Checkout Session removes shipping detailsBreaking changes

What’s new

Within a Checkout Session, the shipping_details top-level field has moved to the collected_information.shipping_details field.

Why is this a breaking change?

This change breaks compatibility because we’re removing the shipping_details field to the collected_information sub-hash on the same Checkout Session resource. Update your integration to reflect the new field name.

Impact

This change affects how you access shipping information on the Checkout Session resource: it improves how the API resource is organized, grouping related information more logically. By moving shipping details into the collected_information object, it becomes clearer that the customer provided this information as part of the checkout process.

To adopt this change:

  1. Review your code that interacts with the Checkout Session resource.
  2. Identify any instances where you’re accessing the shipping_details field.
  3. Update these instances to use collected_information['shipping_details'] instead.

Changes

paramètreModifierRessources ou endpoints
shipping_detailsSupprimé
Checkout.Session

Upgrade

  1. View your current API version in Workbench.
  2. If you use an SDK, upgrade to the corresponding SDK version for this API version.
    • If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-03-31.basil
  3. Upgrade the API version used for webhook endpoints.
  4. Test your integration against the new version.
  5. If you use Connect, test your Connect integration.
  6. In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Related changes

  • Checkout Sessions have lower latency and new update semantics
  • Checkout Session allows shipping option updates
  • Adds permissions parameter to Checkout Sessions
  • Adds optional items to Checkout Sessions and Payment Links
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