Public preview

Adds support to specify different default payout methods for each currency Public preview

What’s new

Adds the defaults.payout_methods property to the Account object in the Accounts v2 API. This property is a per-currency hash that maps ISO currency codes to Payout Method IDs, letting you specify which payout method to use by default for each currency when you update an Account. To unset a default for a specific currency, pass an empty string as the value.

Impact

You can now specify different default payout methods for an account, depending on the currency. Global Payouts uses these defaults when sending money to your recipients.

If your integration previously used configuration.recipient.default_outbound_destination to set a default Payout Method, you must now use defaults.payout_methods to manage default Payout Method assignment. Any existing values you set for your recipients through configuration.recipient.default_outbound_destination are now reflected in defaults.payout_methods on the recipient’s Account object.

For Connect integrations that use v2 Payout Methods, defaults.payout_methods reflect the configured payout methods for your connected accounts.

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: 2026-08-26. 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 .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.