Renames Payment Intent field for linking tax calculationBreaking changes

What’s new

Renames the preview parameter async_workflows to hooks in Payment Intents.

Why is this a breaking change?

The async_workflows preview parameter has been renamed to hooks. Participants of the private payment_intent_with_tax_api preview who want to use this Stripe version must update their integrations to use the new parameter name.

Impact

If you participated in the payment_intent_with_tax_api private preview and want to upgrade to this Stripe version, update your integration to use the new parameter name.

Changes

Parameters	Change	Resources or endpoints
hooks	Added	PaymentIntent PaymentIntent#capture PaymentIntent#confirm + 4 more PaymentIntent#create PaymentIntent#decrement_authorization PaymentIntent#increment_authorization PaymentIntent#update
async_workflows	Removed	PaymentIntent PaymentIntent#capture PaymentIntent#confirm + 4 more PaymentIntent#create PaymentIntent#decrement_authorization PaymentIntent#increment_authorization PaymentIntent#update

Upgrade

View your current API version in Workbench.
If you use an SDK, upgrade to the corresponding SDK version for this API version.
- If you don’t use an SDK, update your API requests to include Stripe-Version: 2025-05-28.preview
Upgrade the API version used for webhook endpoints.
Test your integration against the new version.
If you use Connect, test your Connect integration.
In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.

Replaces tax association status fields