# Updates transaction categories to use flow-specific reversal types and adds Stripe fee tax category ## What’s new Updates the [category](https://docs.stripe.com/api/v2/money-management/transactions/object.md?api-version=2026-04-22.preview#v2_transaction_object-category) property on [Transaction v2](https://docs.stripe.com/api/v2/money-management/transactions/object.md?api-version=2026-04-22.preview) objects to return flow-specific reversal categories instead of the generic `return` category: - `outbound_payment_reversal` - `outbound_transfer_reversal` - `inbound_transfer_reversal` - `received_credit_reversal` - `received_debit_reversal` The new categories provide more granular classification to distinguish between different types of returns, especially when aggregating by `category`. The `return` category is no longer used. This update also introduces a new `stripe_fee_tax` category for taxes charged on Stripe fees. ## Why is this a breaking change? This is a breaking change because the [category](https://docs.stripe.com/api/balance_transactions/object.md?api-version=2026-04-22.preview#balance_transaction_object-category) property returns different enum values than before. If your integration expects the `return` category value or has conditional logic based on this specific value, your code needs to be updated to handle the new reversal category values to avoid errors or unexpected behavior. ## Impact If your integration relies on the generic `return` category value for transaction processing, filtering, or reporting, you must update your code to handle the new flow-specific reversal categories. The generic `return` category no longer appears for new transactions after you upgrade to this API version. You can use the `stripe_fee_tax` to distinguish between fees charged by Stripe and taxes on those fees. ## Changes #### REST API | Values | Change | Enums | | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `inbound_transfer_reversal`, `outbound_payment_reversal`, `outbound_transfer_reversal`, `received_credit_reversal`, `received_debit_reversal`, `stripe_fee_tax` | Added | [V2.MoneyManagement.TransactionEntry.transaction_details](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-category), [V2.MoneyManagement.Transaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-category) | | `return` | Removed | [V2.MoneyManagement.TransactionEntry.transaction_details](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-category), [V2.MoneyManagement.Transaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-category) | #### Ruby This change does not affect the Ruby SDK. #### Python | Values | Change | Enums | | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `inbound_transfer_reversal`, `outbound_payment_reversal`, `outbound_transfer_reversal`, `received_credit_reversal`, `received_debit_reversal`, `stripe_fee_tax` | Added | [V2.MoneyManagement.TransactionEntry.TransactionDetail](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-category), [V2.MoneyManagement.Transaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-category) | | `return` | Removed | [V2.MoneyManagement.TransactionEntry.TransactionDetail](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-category), [V2.MoneyManagement.Transaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-category) | #### PHP | Values | Change | Enums | | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `inbound_transfer_reversal`, `outbound_payment_reversal`, `outbound_transfer_reversal`, `received_credit_reversal`, `received_debit_reversal`, `stripe_fee_tax` | Added | [V2.MoneyManagement.TransactionEntry.transaction_details](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-category), [V2.MoneyManagement.Transaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-category) | | `return` | Removed | [V2.MoneyManagement.TransactionEntry.transaction_details](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-category), [V2.MoneyManagement.Transaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-category) | #### Java This change does not affect the Java SDK. #### Node.js | Values | Change | Enums | | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `inbound_transfer_reversal`, `outbound_payment_reversal`, `outbound_transfer_reversal`, `received_credit_reversal`, `received_debit_reversal`, `stripe_fee_tax` | Added | [V2.MoneyManagement.TransactionEntry.transaction_details](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-category), [V2.MoneyManagement.Transaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-category) | | `return` | Removed | [V2.MoneyManagement.TransactionEntry.transaction_details](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-category), [V2.MoneyManagement.Transaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-category) | #### Go | Values | Change | Enums | | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `inbound_transfer_reversal`, `outbound_payment_reversal`, `outbound_transfer_reversal`, `received_credit_reversal`, `received_debit_reversal`, `stripe_fee_tax` | Added | [V2MoneyManagementTransactionEntryTransactionDetails](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-Category), [V2MoneyManagementTransaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-Category) | | `return` | Removed | [V2MoneyManagementTransactionEntryTransactionDetails](/api/v2/money-management/transaction-entries/object?api-version=2026-04-22.preview#v2_transaction_entry_object-transaction_details-Category), [V2MoneyManagementTransaction](/api/v2/money-management/transactions/object?api-version=2026-04-22.preview#v2_transaction_object-Category) | #### .NET This change does not affect the .NET SDK. ## 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).