upgrade-stripe

The latest Stripe API version is 2026-03-25.dahlia - use this version when upgrading unless the user specifies a different target version. # Upgrading Stripe Versions This guide covers upgrading Stripe API versions, server-side SDKs, Stripe.js, and mobile SDKs. ## Understanding Stripe API Versioning Stripe uses date-based API versions (e.g., `2026-03-25.dahlia`, `2025-08-27.basil`, `2024-12-18.acacia`). Your account’s API version determines request/response behavior. ### Types of Changes **Backward-Compatible Changes** (don’t require code updates): - New API resources - New optional request parameters - New properties in existing responses - Changes to opaque string lengths (e.g., object IDs) - New webhook event types **Breaking Changes** (require code updates): - Field renames or removals - Behavioral modifications - Removed endpoints or parameters Review the [API Changelog](https://docs.stripe.com/changelog.md) for all changes between versions. ## Server-Side SDK Versioning See [SDK Version Management](https://docs.stripe.com/sdks/set-version.md) for details. ### Dynamically-Typed Languages (Ruby, Python, PHP, Node.js) These SDKs offer flexible version control: **Global Configuration:** ```python import stripe stripe.api_version = '2026-03-25.dahlia' ``` ```ruby Stripe.api_version = '2026-03-25.dahlia' ``` ```javascript const stripe = require('stripe')('sk_test_xxx', { apiVersion: '2026-03-25.dahlia' }); ``` **Per-Request Override:** ```python stripe.C...