upgrade-stripe

Guides upgrading Stripe API versions, server-side SDKs, Stripe.js, and mobile SDKs.

1|Updated May 26, 2026
One-click install
npx skills add https://github.com/nimdvir/dima-publishing --skill upgrade-stripe-nimdvir
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: upgrade-stripe
Source: https://github.com/nimdvir/dima-publishing/tree/main/.continue/skills/upgrade-stripe
Command: npx skills add https://github.com/nimdvir/dima-publishing --skill upgrade-stripe-nimdvir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Upgrading Stripe API versions and SDKs involves navigating breaking changes, version-specific behaviors, and platform differences, and mistakes can break payment integrations in production. ## Core Features & Use Cases - API Version Guidance: Explains Stripe's date-based versioning, backward-compatible versus breaking changes, and how to pin explicit API versions in code. - SDK Upgrade Instructions: Covers server-side SDKs (Ruby, Python, PHP, Node.js, Java, Go, .NET), Stripe.js evergreen releases, and iOS, Android, and React Native mobile SDKs. - Testing and Migration Checklist: Provides a step-by-step upgrade checklist and shows how to test new versions using the Stripe-Version header before committing. - Use Case: Your Node.js integration runs on API version 2024-12-18.acacia and you need to move to 2026-05-27.dahlia; follow the checklist to update the SDK, set the apiVersion parameter, test with the Stripe-Version header, and update webhook handlers. ## Quick Start Ask the assistant to walk you through upgrading your Stripe integration from your current API version to 2026-05-27.dahlia, including SDK updates and webhook testing.

Frequently Asked Questions about upgrade-stripe

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade my Stripe API version?▼

Review the API changelog for changes between your current and target versions, update your server-side SDK package, set the apiVersion parameter in your Stripe client initialization, and test using the Stripe-Version header before switching your default version.

What is the latest Stripe API version?▼

The latest Stripe API version covered by this guide is 2026-05-27.dahlia. Stripe uses date-based versions with codenames, and multiple versions coexist so you can adopt new versions in stages.

Should I set an API version for strongly-typed Stripe SDKs like Java or Go?▼

No. Strongly-typed SDKs (Java, Go, .NET) use a fixed API version matching the SDK release. Setting a different version can cause response objects to mismatch the SDK's strong types, so upgrade the SDK package itself instead.

How do I test a new Stripe API version without changing my default?▼

Send requests with the Stripe-Version header set to the target version, or set the apiVersion option in your client initialization. This lets you validate behavior against the new version while your account default stays unchanged.

Does Stripe.js versioning work independently from the API version?▼

No. Each Stripe.js major release (Acacia, Basil, Clover, Dahlia) automatically pairs with its corresponding API version, and you cannot override this association. Load a versioned Stripe.js via the script tag or matching npm major version.

Are Stripe mobile SDKs compatible with older backend API versions?▼

Yes. iOS and Android SDKs work with any Stripe API version used on your backend unless documentation specifies otherwise. Mobile SDKs follow semantic versioning, while the React Native SDK uses a 0.x.y scheme where minor bumps may include breaking changes.