Output format·Finance & Commerce

Upgrading Stripe Versions

Guide for upgrading Stripe API versions and SDKs.

You say
Buy it · $19 Read it before you buy $19 Written by fcakyon · unverified publisher
Context cost
1.4k tokensestimated from the bundle, loaded when it triggers
Bundle
1 file · 5.6 kBtext throughout, nothing executable
Licence
MITpaid listing
Last change
no release on file
Servers it uses
Noneruns standalone

What it does

Guide for upgrading Stripe API versions and SDKs

Installed, it changes the agent in these ways.

What this skill changes about the agent is not written down here yet. The listing was collected from its source, and the description is in its own SKILL.md.

Output format

Produces one artefact, exactly shaped.

e-commercestripe

The skill itself

This is the whole product. A skill is instructions the model reads, so there is nothing behind the listing you cannot see first — the front matter loads with every session, and the body below it loads when the skill triggers.

SKILL.md5.6 kB · 186 lines
--- name: upgrade-stripe description: Guide for upgrading Stripe API versions and SDKs license: MIT ---
7The latest Stripe API version is 2026-07-29.dahlia - use this version when upgrading unless the user specifies a different target version.
8
9# Upgrading Stripe Versions
10
11This guide covers upgrading Stripe API versions, server-side SDKs, Stripe.js, and mobile SDKs.
12
13## Understanding Stripe API Versioning
14
15Stripe uses date-based API versions (e.g., 2026-07-29.dahlia, 2025-08-27.basil, 2024-12-18.acacia). Your account’s API version determines request/response behavior.
16
17### Types of Changes
18
19**Backward-Compatible Changes** (don’t require code updates):
20
21- New API resources
22- New optional request parameters
23- New properties in existing responses
24- Changes to opaque string lengths (e.g., object IDs)
25- New webhook event types
26
27**Breaking Changes** (require code updates):
28
29- Field renames or removals
30- Behavioral modifications
31- Removed endpoints or parameters
32
33Review the [API Changelog](https://docs.stripe.com/changelog.md) for all changes between versions.
34
35## Server-Side SDK Versioning
36
37See [SDK Version Management](https://docs.stripe.com/sdks/set-version.md) for details.
38
39### Dynamically-Typed Languages (Ruby, Python, PHP, Node.js)
40
41These SDKs offer flexible version control:
42
43**Global Configuration:**
44
45```python
46import stripe
47stripe.api_version = '2026-07-29.dahlia'
48```
49
50```ruby
51Stripe.api_version = '2026-07-29.dahlia'
52```
53
54```javascript
55const stripe = require('stripe')('sk_test_xxx', {
56 apiVersion: '2026-07-29.dahlia'
57});
58```
59
60**Per-Request Override:**
61
62```python
63stripe.Customer.create(
64 email="customer@example.com",
65 stripe_version='2026-07-29.dahlia'
66)
67```
68
69### Strongly-Typed Languages (Java, Go, .NET)
70
71These use a fixed API version matching the SDK release date. Don’t set a different API version for strongly-typed languages because response objects might not match the strong types in the SDK. Instead, update the SDK to target a new API version.
72
73### Best Practice
74
75Always specify the API version you’re integrating against in your code instead of relying on your account’s default API version:
76
77```javascript
78// Good: Explicit version
79const stripe = require('stripe')('sk_test_xxx', {
80 apiVersion: '2026-07-29.dahlia'
81});
82
83// Avoid: Relying on account default
84const stripe = require('stripe')('sk_test_xxx');
85```
86
87## Stripe.js Versioning
88
89See [Stripe.js Versioning](https://docs.stripe.com/sdks/stripejs-versioning.md) for details.
90
91Stripe.js uses an evergreen model with major releases (Acacia, Basil, Clover, Dahlia) on a biannual basis.
92
93### Loading Versioned Stripe.js
94
95**Via Script Tag:**
96
97```html
98<script src="https://js.stripe.com/dahlia/stripe.js"></script>
99```
100
101**Via npm:**
102
103```bash
104npm install @stripe/stripe-js
105```
106
107Major npm versions correspond to specific Stripe.js versions.
108
109### API Version Pairing
110
111Each Stripe.js version automatically pairs with its corresponding API version. For instance:
112
113- Dahlia Stripe.js uses 2026-07-29.dahlia API
114- Acacia Stripe.js uses 2024-12-18.acacia API
115
116You can’t override this association.
117
118### Migrating from v3
119
1201. Identify your current API version in code
1212. Review the changelog for relevant changes
1223. Consider gradually updating your API version before switching Stripe.js versions
1234. Stripe continues supporting v3 indefinitely
124
125## Mobile SDK Versioning
126
127See [Mobile SDK Versioning](https://docs.stripe.com/sdks/mobile-sdk-versioning.md) for details.
128
129### iOS and Android SDKs
130
131Both platforms follow **semantic versioning** (MAJOR.MINOR.PATCH):
132
133- **MAJOR**: Breaking API changes
134- **MINOR**: New functionality (backward-compatible)
135- **PATCH**: Bug fixes (backward-compatible)
136
137New features and fixes release only on the latest major version. Upgrade regularly to access improvements.
138
139### React Native SDK
140
141Uses a different model (0.x.y schema):
142
143- **Minor version changes** (x): Breaking changes AND new features
144- **Patch updates** (y): Critical bug fixes only
145
146### Backend Compatibility
147
148All mobile SDKs work with any Stripe API version you use on your backend unless documentation specifies otherwise.
149
150## Upgrade Checklist
151
1521. Review the [API Changelog](https://docs.stripe.com/changelog.md) for changes between your current and target versions
1532. Check [Upgrades Guide](https://docs.stripe.com/upgrades.md) for migration guidance
1543. Update server-side SDK package version (e.g., npm update stripe, pip install --upgrade stripe)
1554. Update the apiVersion parameter in your Stripe client initialization
1565. Test your integration against the new API version using the Stripe-Version header
1576. Update webhook handlers to handle new event structures
1587. Update Stripe.js script tag or npm package version if needed
1598. Update mobile SDK versions in your package manager if needed
1609. Store Stripe object IDs in databases that accommodate up to 255 characters (case-sensitive collation)
161
162## Testing API Version Changes
163
164Use the Stripe-Version header to test your code against a new version without changing your default:
165
166```bash
167curl https://api.stripe.com/v1/customers \
168 -u sk_test_xxx: \
169 -H "Stripe-Version: 2026-07-29.dahlia"
170```
171
172Or in code:
173
174```javascript
175const stripe = require('stripe')('sk_test_xxx', {
176 apiVersion: '2026-07-29.dahlia' // Test with new version
177});
178```
179
180## Important Notes
181
182- Your webhook listener should handle unfamiliar event types gracefully
183- Test webhooks with the new version structure before upgrading
184- Breaking changes are tagged by affected product areas (Payments, Billing, Connect, etc.)
185- Multiple API versions coexist simultaneously, enabling staged adoption
186
In the file
SKILL.md711 words
Files1
LicenceMIT
Why you can read it

Nothing in a skill executes. The client loads the text and the model follows it, so a skill can be audited the way a runbook is — by reading it.

What it costs in context

Skills are not billed by the call. They are paid for in context: every token the instructions occupy is a token your code, your diff and your conversation cannot use. Here is what this one takes and when it takes it.

≈30
always loaded
The name and description, so the model knows the skill exists and when to reach for it.
1,370
on trigger
The instruction body, read only when the skill fires.
0.70%
of a 200k window
Ten skills this size would take about 7% of the window before you open a file.
050k100k150k200k context window

1.4k tokens, estimated from the bundle at four bytes to the token, held for the rest of the session once it triggers. Middling. Fine to keep on in a project where you use it weekly, worth unloading in one where you never do.

Servers bill, skills cost

A server charges by the month. A skill charges once per session, in context, and then keeps charging it for as long as the session lives.

Before and after

The same question, put to the same model twice: once as it comes, and once with these instructions loaded.

No worked example has been published for this skill yet.

Adoption
Installsnone yet
Ratingno reviews yet

The procedure it runs

The procedure has not been published here. It is in the skill’s own SKILL.md, which its author has not sent to the marketplace yet.

Prose, not code

These steps are written for a model to follow, not executed by a runtime. It can still be told to skip one, and it will say so when it does.

Servers it uses

None. This skill calls no MCP servers at all.

Everything it needs is in the instructions, so it works in a project with nothing connected — the model reads the file and changes how it works with what it can already reach.

It writes no files and reaches no network. All it changes is how the model reasons and writes.

What it asks for
Writes filesno
Network accessno

Read from the allowed-tools line of this skill’s own SKILL.md. A skill grants no permissions of its own — it can only ask for tools your client already has.

What it will not do

Every skill is narrow, and the useful ones say where they stop. These are the jobs this one is the wrong tool for.

What this skill is not for has not been published here. Nothing is implied by that: it is a section the author has not filled in.

What is in the bundle

1 file, 5.6 kB on disk. A bundle is text throughout: the instructions the model reads, plus the templates it fills in.

  • SKILL.md5.6 kB
What is not in it

No dependencies and nothing executable: a skill is text the agent reads, so the bundle is 1 file you can review in full before installing. The MIT licence covers the templates and examples as well as the instructions.

Install

Installing copies the bundle into your project. Nothing runs at install time — the files sit on disk until the model reads them.

$19 once
Upgrading Stripe Versions · MIT · fcakyon
one-time
Price$19 once
LicenceMIT — the author’s, unchanged by this purchase
Paid throughStripe, once, on the card you add at the checkout
Keeps workingfor good — the files are yours once they are on disk
Updatesevery update its author ships, delivered through this account

You can read the whole bundle before paying — the SKILL.md above is the product, not a preview of it. What the money buys is the delivery: the folder packaged and handed to your machine by key, every update its author ships, and our support if it does not do what this listing says. The terms of use are MIT, set by the author and unchanged by buying it here.

Payment runs through Stripe, on a page like this one rather than a redirect. Once there is an account it joins the same mcprush invoice as everything else you run, so there is never a second card to enter.

Which clients pick it up on their own

A skill is a folder of text. A client with a skills folder reads it without being told; everywhere else the same text works, it is just handed to the model rather than found.

Claude Code.claude/skills/
Claude Desktop
ChatGPT
Cursor.cursor/skills/
VS Code.github/skills/
Codex CLI.agents/skills/
Gemini CLI.gemini/skills/
Grok.grok/skills/
Zed.agents/skills/
Windsurf.windsurf/skills/
Agent SDK.claude/skills/
HTTP / API
This release
Versionnot versioned
Publishedno release date on file
Price$19
Referencefcakyon/upgrading-stripe-versions

Versions

Its author publishes no version number, so there is nothing here to pin to: what you install is the folder as it stands today. Instructions change more often than APIs do — a skill can be rewritten entirely without anything it depends on moving.

v
  • No earlier releases have been published to the marketplace.
Pinning

Nothing to pin to: this skill carries no version number of its own. What you install is what the folder holds on the day you install it.

Reviews

no reviews yet · no installs yet

Nobody has reviewed this skill yet. The rating is the mean of the reviews written here, so there is none until somebody writes the first.

Who can post

Only accounts that have had the skill installed for fourteen days, so a review is written after living with it rather than after reading it. Publishers may reply once.

Who wrote it

FC
fcakyon

Publishes on mcprush.

0 servers listed3 skills listednot claimed
Profile
Publisher
Servers0