Each major release, such as Acacia, includes changes that aren’t backward-compatible with previous releases. Upgrading to a new major release can require updates to existing code. Each monthly release includes only backward-compatible changes, and uses the same name as the last major release. You can safely upgrade to a new monthly release without breaking any existing code. The current version is 2025-08-27.basil. For information on all API versions, view our API changelog.
- Starting from
stripe-ruby v9
, the requests you send usingstripe-ruby
align with the API version that was current when your version ofstripe-ruby
was released. - On
stripe-ruby v8
or lower, requests made withstripe-ruby
use your Stripe account’s default API version, controlled in Workbench.
You can override the API version in your code in all versions.
To override the API version, assign the version to the Stripe.
property, or set it per-request. When overriding it per-request, methods on the returned object reuse the same Stripe version.
Webhook events use the API version that’s set during your webhook’s endpoint creation. Otherwise, they use your Stripe account’s default API version (controlled in Workbench). If you’re on stripe-ruby v9
or later, match your webhook endpoint API version to the version pinned by your stripe-ruby
version (Stripe.
property).
You can upgrade your API version in Workbench. As a precaution, use API versioning to test a new API version before committing to an upgrade.