upgrade-stripe
Installation
Summary
Comprehensive guide for upgrading Stripe API versions across all SDK types and platforms.
- Covers server-side SDKs (dynamically-typed languages like Python, Node.js, Ruby allow per-request or global version overrides; strongly-typed languages like Java, Go, .NET require SDK updates instead)
- Stripe.js uses an evergreen model with biannual major releases (Acacia, Basil, Clover) that automatically pair with corresponding API versions; v3 continues to be supported indefinitely
- Mobile SDKs (iOS, Android) use semantic versioning; React Native uses a 0.x.y schema where minor version changes include breaking changes
- Includes testing strategies using the
Stripe-Versionheader and a nine-step upgrade checklist covering changelog review, SDK updates, webhook handler changes, and database schema considerations
SKILL.md
The latest Stripe API version is 2026-04-22.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-04-22.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
Related skills