# Renames the tax IDs property to tax ID in Checkout Session collected information ## What’s new Renames the [tax_ids](https://docs.stripe.com/api/checkout/sessions/object.md?api-version=2026-06-24.preview#checkout_session_object-collected_information-tax_ids) property on the [collected_information](https://docs.stripe.com/api/checkout/sessions/object.md?api-version=2026-07-29.preview#checkout_session_object-collected_information) hash of a [Checkout Session](https://docs.stripe.com/api/checkout/sessions.md?api-version=2026-07-29.preview) from `tax_ids` (an array) to [tax_id](https://docs.stripe.com/api/checkout/sessions/object.md?api-version=2026-07-29.preview#checkout_session_object-collected_information-tax_id) (a single object). Previously, `collected_information.tax_ids` returned an array of tax ID objects. On newer API versions, `collected_information.tax_id` returns a single tax ID object, or `null` if no tax ID was collected. ## Why is this a breaking change? On API versions that include this change, the `collected_information.tax_ids` array property no longer exists and is replaced by `collected_information.tax_id`, a single object. If your integration reads `collected_information.tax_ids` and iterates over the array, you must update your code to read `collected_information.tax_id` as a single object instead. On older API versions, a compatibility layer continues to return `tax_ids` as a single-element array. ## Impact If your integration accesses `collected_information.tax_ids` on a Checkout Session response, you must update it to use `collected_information.tax_id` instead. Rather than iterating over an array, read the property directly as a single tax ID object (or handle `null` if no tax ID was collected). ## Changes #### REST API | Parameters | Change | Resources or endpoints | | --- | --- | --- | | `tax_id` | Added | [Checkout.Session.collected_information](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | | `tax_ids` | Removed | [Checkout.Session.collected_information](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | #### Ruby | Parameters | Change | Resources or methods | | --- | --- | --- | | `tax_id` | Added | [Checkout::Session::CollectedInformation](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | | `tax_ids` | Removed | [Checkout::Session::CollectedInformation](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | #### Python | Parameters | Change | Resources or methods | | --- | --- | --- | | `tax_id` | Added | [Checkout.Session.CollectedInformation](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | | `tax_ids` | Removed | [Checkout.Session.CollectedInformation](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | #### PHP | Parameters | Change | Resources or methods | | --- | --- | --- | | `tax_id` | Added | [Checkout.Session.collected_information](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | | `tax_ids` | Removed | [Checkout.Session.collected_information](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | #### Java | Parameters | Change | Resources or methods | | --- | --- | --- | | `taxId` | Added | [checkout.Session.collected_information](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | | `taxIds` | Removed | [checkout.Session.collected_information](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | #### Node.js | Parameters | Change | Resources or methods | | --- | --- | --- | | `tax_id` | Added | [Checkout.Session.collected_information](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | | `tax_ids` | Removed | [Checkout.Session.collected_information](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | #### Go | Parameters | Change | Resources or methods | | --- | --- | --- | | `TaxID` | Added | [CheckoutSessionCollectedInformation](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | | `TaxIDs` | Removed | [CheckoutSessionCollectedInformation](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | #### .NET | Parameters | Change | Resources or methods | | --- | --- | --- | | `TaxId` | Added | [Checkout.Session.CollectedInformation](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | | `TaxIds` | Removed | [Checkout.Session.CollectedInformation](/api/checkout/sessions/object?api-version=2026-07-29.preview#checkout_session_object-collected_information) | ## 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. 2. 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-07-29.preview` 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Ruby SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Python SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your PHP SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Java SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Node SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your Go SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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. 2. Upgrade your .NET SDK to the latest version. 3. Upgrade the API version used for [webhook endpoints](https://docs.stripe.com/webhooks/versioning.md). 4. [Test your integration](https://docs.stripe.com/testing.md) against the new version. 5. If you use Connect, [test your Connect integration](https://docs.stripe.com/connect/testing.md). 6. 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). ## Related changes - [Renames the taxes parameter to tax items in industry metadata payment details](https://docs.stripe.com/changelog/dahlia/2026-07-29/industry-metadata-taxes-parameter-rename.md) - [Adds the live mode indicator to the Tax Location object](https://docs.stripe.com/changelog/dahlia/2026-07-29/tax-location-live-mode-indicator.md)