# Adds support for disabling payout methods ## What’s new Adds the ability to [disable](https://docs.stripe.com/api/v2/money-management/payout-methods/disable.md?api-version=2026-08-26.preview) a [v2 Payout Method](https://docs.stripe.com/api/v2/money-management/payout-methods.md?api-version=2026-08-26.preview) for use in outbound money movement, which labels the [usage_status](https://docs.stripe.com/api/v2/money-management/payout-methods/object.md?api-version=2026-08-26.preview#v2_payout_method_object-usage_status) as `disabled` for `payments` and `transfers`. ## Why is this a breaking change? A payout method can now show `disabled` as the `usage_status` for `payments` and `transfers`. If your integration doesn’t handle payment methods with this value, you might experience unexpected failures. ## Impact You can now disable a v2 Payout Method to prevent using that payout method for outbound money movement. The resulting status is non-terminal, and you can re-enable the payout method by creating a new [Outbound Setup Intent](https://docs.stripe.com/api/v2/money-management/outbound-setup-intents.md?api-version=2026-08-26.preview). ## Changes #### REST API | Endpoint | Change | Resource | | --- | --- | --- | | `disable` | Added | [V2.MoneyManagement.PayoutMethod](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object) | | Value | Change | Enums | | --- | --- | --- | | `disabled` | Added | [V2.MoneyManagement.PayoutMethod.usage_status.payments](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-payments), [V2.MoneyManagement.PayoutMethod.usage_status.transfers](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-transfers), [V2.MoneyManagement.PayoutMethod#list.usage_status.payments](/api/v2/money-management/payout-methods/list?api-version=2026-08-26.preview#v2_list_payout_methods-usage_status-payments), [V2.MoneyManagement.PayoutMethod#list.usage_status.transfers](/api/v2/money-management/payout-methods/list?api-version=2026-08-26.preview#v2_list_payout_methods-usage_status-transfers) | | Code | Change | | | --- | --- | --- | | `default_payout_method_cannot_be_disabled` | Added | `cannot_proceed` | #### Ruby | Method | Change | Resource | | --- | --- | --- | | `disable` | Added | [V2::MoneyManagement::PayoutMethod](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object) | #### Python | Method | Change | Resource | | --- | --- | --- | | `disable` | Added | [v2.money_management.PayoutMethod](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object) | | Value | Change | Enums | | --- | --- | --- | | `disabled` | Added | [V2.MoneyManagement.PayoutMethod.UsageStatus.payments](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-payments), [V2.MoneyManagement.PayoutMethod.UsageStatus.transfers](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-transfers), [v2.money_management.PayoutMethodListParamsUsageStatus.payments](/api/v2/money-management/payout-methods/list?api-version=2026-08-26.preview#v2_list_payout_methods-usage_status-payments), [v2.money_management.PayoutMethodListParamsUsageStatus.transfers](/api/v2/money-management/payout-methods/list?api-version=2026-08-26.preview#v2_list_payout_methods-usage_status-transfers) | | Code | Change | | | --- | --- | --- | | `default_payout_method_cannot_be_disabled` | Added | `CannotProceedError` | #### PHP | Method | Change | Resource | | --- | --- | --- | | `disable` | Added | [V2.MoneyManagement.PayoutMethod](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object) | | Value | Change | Enums | | --- | --- | --- | | `disabled` | Added | [V2.MoneyManagement.PayoutMethod.usage_status.payments](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-payments), [V2.MoneyManagement.PayoutMethod.usage_status.transfers](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-transfers) | #### Java | Method | Change | Resource | | --- | --- | --- | | `disable` | Added | [v2.moneymanagement.PayoutMethod](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object) | | Value | Change | Enums | | --- | --- | --- | | `disabled` | Added | [v2.moneymanagement.PayoutMethodListParams.usage_status.payments](/api/v2/money-management/payout-methods/list?api-version=2026-08-26.preview#v2_list_payout_methods-usage_status-payments), [v2.moneymanagement.PayoutMethodListParams.usage_status.transfers](/api/v2/money-management/payout-methods/list?api-version=2026-08-26.preview#v2_list_payout_methods-usage_status-transfers) | #### Node.js | Method | Change | Resource | | --- | --- | --- | | `disable` | Added | [V2.MoneyManagement.PayoutMethod](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object) | | Value | Change | Enums | | --- | --- | --- | | `disabled` | Added | [V2.MoneyManagement.PayoutMethod.usage_status.payments](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-payments), [V2.MoneyManagement.PayoutMethod.usage_status.transfers](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-transfers), [V2.MoneyManagement.PayoutMethodListParams.usage_status.payments](/api/v2/money-management/payout-methods/list?api-version=2026-08-26.preview#v2_list_payout_methods-usage_status-payments), [V2.MoneyManagement.PayoutMethodListParams.usage_status.transfers](/api/v2/money-management/payout-methods/list?api-version=2026-08-26.preview#v2_list_payout_methods-usage_status-transfers) | | Code | Change | | | --- | --- | --- | | `default_payout_method_cannot_be_disabled` | Added | `CannotProceedError` | #### Go | Method | Change | Resource | | --- | --- | --- | | `Disable` | Added | [V2MoneyManagementPayoutMethod](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object) | | Value | Change | Enums | | --- | --- | --- | | `disabled` | Added | [V2MoneyManagementPayoutMethodUsageStatus.Payments](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-Payments), [V2MoneyManagementPayoutMethodUsageStatus.Transfers](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object-usage_status-Transfers) | | Code | Change | | | --- | --- | --- | | `default_payout_method_cannot_be_disabled` | Added | `CannotProceedError` | #### .NET | Method | Change | Resource | | --- | --- | --- | | `Disable` | Added | [V2.MoneyManagement.PayoutMethod](/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview#v2_payout_method_object) | ## 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-08-26.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).