# Adds new tax registration types and product tax details for Stripe Tax for tickets ## What’s new Adds eight US event tax registration types to the [type](https://docs.stripe.com/api/tax/registrations/create.md?api-version=2026-04-22.preview#tax_registration_create-country_options-us-type) parameter on the [Tax Registration](https://docs.stripe.com/api/tax/registrations/object.md?api-version=2026-04-22.preview) object: - `admissions_tax` - `attendance_tax` - `entertainment_tax` - `gross_receipts_tax` - `hospitality_tax` - `luxury_tax` - `resort_tax` - `tourism_tax` Also adds the [tax_details](https://docs.stripe.com/api/products/object.md?api-version=2026-04-22.preview#product_object-tax_details) property on the [Product](https://docs.stripe.com/api/products/object.md?api-version=2026-04-22.preview) object. ## Impact If you use [Stripe Tax for tickets](https://docs.stripe.com/tax/tax-for-tickets/integration-guide.md) and need to register for US event-related taxes, you can now create tax registrations for all eight supported local tax types through the API. Previously, these registration types were only accessible through the Stripe Dashboard or [SDK private parameters](https://docs.stripe.com/sdks/server-side.md#undocumented-params-and-fields). If you retrieve products through `/v1/products`, responses now include the `tax_details` property. ## Changes #### REST API | Parameters | Change | Resources or endpoints | | ------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- | | `tax_details` | Added | [Product](/api/products/object?api-version=2026-04-22.preview#product_object) | | `admissions_tax`, `attendance_tax`, `entertainment_tax`, `gross_receipts_tax`, `hospitality_tax`, `luxury_tax`, `resort_tax`, `tourism_tax` | Added | [Tax.Registration#create.country_options.us](/api/tax/registrations/create?api-version=2026-04-22.preview#tax_registration_create-country_options-us) | #### Ruby | Parameters | Change | Resources or methods | | ------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tax_details` | Added | [Product](/api/products/object?api-version=2026-04-22.preview#product_object) | | `admissions_tax`, `attendance_tax`, `entertainment_tax`, `gross_receipts_tax`, `hospitality_tax`, `luxury_tax`, `resort_tax`, `tourism_tax` | Added | [Tax::RegistrationCreateParams::CountryOption::Me](/api/tax/registrations/create?api-version=2026-04-22.preview#tax_registration_create-country_options-us) | #### Python | Parameters | Change | Resources or methods | | ------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | `tax_details` | Added | [Product](/api/products/object?api-version=2026-04-22.preview#product_object) | | `admissions_tax`, `attendance_tax`, `entertainment_tax`, `gross_receipts_tax`, `hospitality_tax`, `luxury_tax`, `resort_tax`, `tourism_tax` | Added | [tax.RegistrationCreateParamsCountryOptionMe](/api/tax/registrations/create?api-version=2026-04-22.preview#tax_registration_create-country_options-us) | #### PHP | Parameters | Change | Resources or methods | | ------------------------------------------------------------------------------------------------------------------------------------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tax_details` | Added | [Product](/api/products/object?api-version=2026-04-22.preview#product_object) | | `admissions_tax`, `attendance_tax`, `entertainment_tax`, `gross_receipts_tax`, `hospitality_tax`, `luxury_tax`, `resort_tax`, `tourism_tax` | Added | [Tax\Registration.create().$params.country_option.me](/api/tax/registrations/create?api-version=2026-04-22.preview#tax_registration_create-country_options-us) | #### Java | Parameters | Change | Resources or methods | | ---------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | `taxDetails` | Added | [Product](/api/products/object?api-version=2026-04-22.preview#product_object) | | `admissionsTax`, `attendanceTax`, `entertainmentTax`, `grossReceiptsTax`, `hospitalityTax`, `luxuryTax`, `resortTax`, `tourismTax` | Added | [tax.RegistrationCreateParams.country_options.us](/api/tax/registrations/create?api-version=2026-04-22.preview#tax_registration_create-country_options-us) | #### Node.js | Parameters | Change | Resources or methods | | ------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | `tax_details` | Added | [Product](/api/products/object?api-version=2026-04-22.preview#product_object) | | `admissions_tax`, `attendance_tax`, `entertainment_tax`, `gross_receipts_tax`, `hospitality_tax`, `luxury_tax`, `resort_tax`, `tourism_tax` | Added | [Tax.RegistrationCreateParams.country_options.us](/api/tax/registrations/create?api-version=2026-04-22.preview#tax_registration_create-country_options-us) | #### Go | Parameters | Change | Resources or methods | | ---------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | | `TaxDetails` | Added | [Product](/api/products/object?api-version=2026-04-22.preview#product_object) | | `AdmissionsTax`, `AttendanceTax`, `EntertainmentTax`, `GrossReceiptsTax`, `HospitalityTax`, `LuxuryTax`, `ResortTax`, `TourismTax` | Added | [TaxRegistrationCountryOptionsUsParams](/api/tax/registrations/create?api-version=2026-04-22.preview#tax_registration_create-country_options-us) | #### .NET | Parameters | Change | Resources or methods | | ---------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | | `TaxDetails` | Added | [Product](/api/products/object?api-version=2026-04-22.preview#product_object) | | `AdmissionsTax`, `AttendanceTax`, `EntertainmentTax`, `GrossReceiptsTax`, `HospitalityTax`, `LuxuryTax`, `ResortTax`, `TourismTax` | Added | [TaxRegistrationCountryOptionsUsOptions](/api/tax/registrations/create?api-version=2026-04-22.preview#tax_registration_create-country_options-us) | ## Upgrade #### REST API 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. 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](https://docs.stripe.com/api/versioning.md) to include `Stripe-Version: 2026-04-22.preview` 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Ruby SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Python SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your PHP SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Java SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Node SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your Go SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [View your current API version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench. 1. Upgrade your .NET SDK to the latest version. 1. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 1. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 1. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 1. In Workbench, [perform the upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade). You can [roll back the version](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) for 72 hours. Learn more about [Stripe API upgrades](https://docs.stripe.com/upgrades.md).