lec1892_code | Stripe Developers | Page 1

proper sonnetBOT Jun 10, 2025, 5:22 PM

#

👋 Welcome to your new thread!

⏲️ We'll be here soon! Typically we respond in a few minutes, but sometimes we might take a bit longer if the server is busy or if you have a particularly tricky question.

⏱️ We close idle threads, which makes them read-only. Once a thread is closed it won't be reopened, but you can always start a new thread if you have another question.

🔗 This thread will always be available, even after it's closed. You can find it again using Discord's search, or you can save this link: https://discord.com/channels/841573134531821608/1382047312137814148

📝 Have more to share? Add more details, code, screenshots, videos, etc. below.

#

verbal turret Jun 10, 2025, 5:24 PM

#

Hello there

#

You can't override the API version via versioning for Java as it is a fixed type language so the SDK version is pinned to an API version.

keen silo Jun 10, 2025, 5:25 PM

#

Got it.
Do you have a new version release calendar?

verbal turret Jun 10, 2025, 5:27 PM

#

For upcoming releases?

#

And are you talking about for the SDK or the API?

keen silo Jun 10, 2025, 5:29 PM

#

yes, a calendar For upcoming releases
good question. Do you have a calendar for both?

verbal turret Jun 10, 2025, 5:30 PM

#

For the API you can read about our release schedule here: https://stripe.com/blog/introducing-stripes-new-api-release-process

No guaranteed release calendar for the SDK though updates are made frequently. You would want to watch the Changelog for that info: https://github.com/stripe/stripe-java/blob/master/CHANGELOG.md

keen silo Jun 10, 2025, 5:33 PM

#

thank you
I have one more question, let me elaborate

#

Let's suppose that today my backend app is using the SDK version 29.2.0, and the Stripe account attached to this backend is on the 2025-05-28.basil.
Let's suppose tomorrow Stripe releases the SDK version 30.0.0 and the API version 2025-06-11-namehere.
I will upgrade my backend SDK version and handle all breaking changes in the development environment, and I will test everything on a Stripe test account or using the Stripe test mode.The Stripe live mode account will not have its API version upgraded yet.
If the process of handling breaking changes and testing takes longer than expected, let's say 40 days, Stripe will release a new API version and a new SDK too.
Now, my backend code can deal with the SDK version 30.0.0, but my Stripe live account is still in the old API version and can only be upgraded to the latest API version. It cannot be upgraded to the version that matches my backend.
What to do in this scenario?

verbal turret Jun 10, 2025, 5:46 PM

#

When you upgrade to a certain SDK version it sets the API Version regardless of your account default version.

#

So you don't have to worry about the account default in this case.

#

What you do need to do is ensure your Webhook endpoints are on the correct version

#

You can specify the endpoint version via the API: https://docs.stripe.com/api/webhook_endpoints/create#create_webhook_endpoint-api_version

Create a webhook endpoint | Stripe API Reference

Complete reference documentation for the Stripe API. Includes code snippets and examples for our Python, Java, PHP, Node.js, Go, Ruby, and .NET libraries.

keen silo Jun 10, 2025, 5:54 PM

#

got it
do you know if I can modify the api version of an existing webhook?

verbal turret Jun 10, 2025, 5:55 PM

#

You can't -- you would need to recreate it.

#lec1892_code