Support for APIs in the new API version 2024-09-30.acacia #1458
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Changelog
This release changes the pinned API version to
2024-09-30.acacia
. Please read the API Upgrade Guide and carefully review the API changes before upgrading.Please refer to our migration guide for v13 for more information about the backwards incompatible changes.
❗
StripeClient
and related changesStripeClient
and requestor logic toAPIRequestor
.StripeClient#request
is still available, but is deprecated and will be removed. We encourageStripeClient#raw_request
as a replacement (see other breaking changes for more detail).StripeClient
as the the entry-point to the service-based pattern, a new interface for calling the Stripe API with many benefits over the existing resource-based paradigm. Services are available under thev1
andv2
accessors.retrieve
before doing anupdate
.Other breaking changes
0
->2
2
->5
StripeClient#connection_manager
. This was a legacy method from years ago.retrieve
method now requiresparams
to be passed as the first argument. Existing calls to singletonretrieve
method with onlyopts
argument will have to be updated to account for the addition ofparams
argument.Stripe.raw_request()
method that was recently added toStripeClient
. This will use the configuration set on the StripeClient instead of the global configuration used before.APIResource.request
. Instead, useStripeClient#raw_request
now.APIResource.execute_resource_request
. However, we discourage use of this in favor ofStripeClient#raw_request
.APIRequestor.execute_request
(previouslyStripeClient.execute_request
). It now returns all request options from our internal request framework as the second value in the returned tuple, instead of only the API key used:Additions
Billing.MeterEvent
,Billing.MeterEventAdjustments
,Billing.MeterEventSession
,Billing.MeterEventStream
and the new Events APICore.Events
in the v2 namespaceparse_thin_event()
on theStripeClient
class to parse thin events.