• Breaking changes
• Public preview

Adds generic error types for Payout Methods Breaking changes Public preview

What’s new

Adds the following generic error codes to replace specific error codes for each Payout Method action:

• payout _ method _ cannot _ be _ updated
• payout _ method _ cannot _ be _ archived
• payout _ method _ cannot _ be _ unarchived

Also adds a controlled_by_alternate_resource generic error type for modifications to resources that are controlled by another API resource.

Why is this a breaking change?

With the change from type-specific errors for Payout Methods to generic errors, you must update any error handling to match these codes. If your integration branches on error types, you must also add handling for the new controlled_by_alternate_resource error type.

Impact

You can now use the generic error types in your integrations that use Payout Methods. With generic error types, you no longer need to handle type-specific error codes as new types are introduced.

Changes

Upgrade

1. View your current API version 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 to include Stripe-Version: 2025-12-15. preview

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.

Related changes

• Creating a Payout Method now triggers an event
• Global Payouts adds support for 13 new countries for cross-border payouts