Public preview
Adds Stripe Tax support for ticket sales Public preview
What’s new
Adds Stripe Tax support for calculating tax on ticket sales and other event transactions based on event location rather than customer location.
Adds support for tax on ticket sales to Stripe Tax using the following new elements:
- The Tax Locations API for managing venues and event spaces
- Performance location properties on existing Stripe Tax APIs and the Products API
- A requirements.performance_location property on the TaxCode object that indicates whether a particular tax code supports or requires a performance location
- The following tax registration enum values on the TaxRegistration object’s country_options.us.type property:
- admissions _ tax
- entertainment _ tax
- tourism _ tax
Impact
If you sell tickets or other event-based goods and services and use Stripe Tax, you can now calculate tax based on the event’s location instead of the customer’s location. To do so, create a Tax Location object representing the event location and pass its ID as the performance_location when calculating tax.
You can also support event-related US tax registration types and access event-related tax breakdown values.
Changes
| Change | Resource | |
|---|---|---|
| Added | Tax. Location | |
| Endpoints | Change | Resource |
| create list retrieve | Added | Tax. Location |
| Parameters | Change | Resources or endpoints |
| performance_location | Added | Tax. Calculation#create. line_items[] Tax.CalculationLineItem |
| tax_details | Added | Checkout. Session#create. line_items[]. price_data. product_data Checkout. Session#update. line_items[]. price_data. product_data Invoice#add_lines. lines[]. price_data. product_data + 7 more Invoice#update_lines. lines[]. price_data. product_data InvoiceLineItem#update. price_data. product_data PaymentLink#create. line_items[]. price_data. product_data Plan#create. product[0] Price#create. product_data Product#create Product#update |
| admissions_tax attendance_tax entertainment_tax gross_receipts_tax hospitality_tax luxury_tax resort_tax tourism_tax | Added | Tax. Registration. country_options. us |
| requirements | Added | TaxCode |
| Values | Change | Enums |
| performance | Added | Tax.CalculationLineItem.tax_breakdown[] Tax.Calculation.shipping_cost.tax_breakdown[] Tax.Transaction.shipping_cost.tax_breakdown[] |
| admissions_tax attendance_tax entertainment_tax gross_receipts_tax hospitality_tax luxury_tax resort_tax tourism_tax | Added | Tax.CalculationLineItem.tax_breakdown[].tax_rate_details Tax.Calculation.shipping_cost.tax_breakdown[].tax_rate_details Tax.Calculation.tax_breakdown[].tax_rate_details + 3 more Tax.Transaction.shipping_cost.tax_breakdown[].tax_rate_details Tax. Registration#create. country_options. us Tax. Registration. country_options. us |
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-03-25. 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.