- Breaking changes
- Public preview
Renames the taxes parameter to tax items in industry metadata payment details Breaking changes Public preview
What’s new
Renames the taxes parameter to tax_items within the total.tax hash for car rental, lodging and flight payment details. This affects the payment_details parameter when you create, update, confirm or capture a PaymentIntent, and when you update or capture a Charge.
The renamed parameter applies to all three industry verticals:
- payment_details.car_rental_data.total.tax.tax_items
- payment_details.lodging_data.total.tax.tax_items
- payment_details.flight_data.total.tax.tax_items
Previously, on older API versions, requests using taxes were automatically converted to tax_items and responses returned taxes for backward compatibility.
Why is this a breaking change?
Previously, the parameter was named taxes within the total.tax hash. On 2026-07-29.preview and newer versions, the API no longer accepts taxes and returns a parameter_unknown error. You must update any requests that set total.tax.taxes to use total.tax.tax_items instead.
Impact
You can no longer use taxes in the total.tax hash on 2026-07-29.preview or newer – sending it returns a parameter_unknown error. Update your code to use tax_items instead. To update your integration, see Industry metadata.
Changes
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: 2026-07-29. preview
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.