apiwatch

All changes / Stripe

Breaking rest

In Stripe's public preview API version 2026-07-29.preview, total.tax.taxes in car rental, lodging and flight payment_details was renamed to tax_items; sending taxes returns a parameter_unknown error

Took effect · Stripe API 2026-07-29.preview (public preview) — payment_details.{car_rental_data,lodging_data,flight_data}.total.tax.taxes renamed to tax_items (PaymentIntents, Charges)

Reviewed against the vendor source on Sep 24, 2026 (AI-assisted review). Key facts are re-checked against the source daily.

What changes

Industry metadata payment_details is a public preview feature that needs the 2026-07-29.preview version header or a later preview version. On those versions the API no longer accepts taxes. On older versions taxes was converted to tax_items. The rename covers car rental, lodging and flight payment_details on PaymentIntent create, update, confirm and capture, and on Charge update and capture.

Breaking: Calls fail after this date.

What to do

Rename total.tax.taxes to total.tax.tax_items in car_rental_data, lodging_data and flight_data payment_details before moving to 2026-07-29.preview, and read tax_items from responses.

Strings to search for

"taxes"'taxes'taxes:taxes=tax.taxesTax.TaxesTaxes:Taxes =

Counts only in files that mention stripe + car_rental_data or stripe + lodging_data or stripe + flight_data or stripe + CarRentalData or stripe + LodgingData or stripe + FlightData.

Source

https://docs.stripe.com/changelog/dahlia/2026-07-29/industry-metadata-taxes-parameter-rename.md