Historically, we’ve released new API features as soon as they’re ready for production—regardless of whether they’re backwards-compatible or no

Introducing Stripe’s new API release process

submited by

Style Pass

2024-10-02 18:00:03

Historically, we’ve released new API features as soon as they’re ready for production—regardless of whether they’re backwards-compatible or not. While this allowed us to give you access to the newest features right away, you also told us that it would be easier to plan your engineering roadmap if you knew when we were going to make updates to our API.

We’ve heard your feedback. We’re introducing a new release cadence and versioning system for all API endpoints that combines twice-yearly major updates1 with monthly feature enhancements. This set release schedule gives you the predictability and clarity that you need to better plan your engineering cycles.

This image is meant to illustrate the new release schedule and versioning format, and does not reflect Stripe’s actual release dates.

To help you understand what’s changing in each new API version (and why), we’ve also redesigned our developer changelog. While the previous version of our changelog listed all updates to the Stripe API, you asked for more help understanding which changes apply to your specific API version.