Backend 3,747 installs

Upgrading Stripe Versions

by stripe/ai

Guide for upgrading Stripe API versions and SDKs

Skill content

The latest Stripe API version is 2026-05-27.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-05-27.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