Updates schedule customization for weekly and monthly payoutsBreaking changes

What’s new

You can now configure more precise weekly or monthly payout schedules through the Balance Settings API. Previously, you could only choose one day of the week or month for a payout.

We’ve renamed monthly_anchor to monthly_payouts_days, which can now configure multiple days of the month for payouts.
We’ve renamed weekly_anchor to weekly_payouts_days, which can now configure multiple days of the week for payouts.

Why is this a breaking change?

The weekly_anchor and monthly_anchor fields have been replaced with weekly_payouts_days and monthly_payout_days, respectively.

Impact

If you participate in the Accounts v2 API public preview and want to use API version 2025-07-30.preview or later, update your balance settings integration to use the weekly_payout_days or monthly_payout_days fields.

Changes

Parameters	Change	Resources or endpoints
monthly_payout_daysweekly_payout_days	Added	BalanceSettings#update.payouts.schedule BalanceSettings.payouts.schedule
monthly_anchorweekly_anchor	Removed	BalanceSettings#update.payouts.schedule BalanceSettings.payouts.schedule

Upgrade

View your current API version in Workbench.
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-07-30.preview
Upgrade the API version used for webhook endpoints.
Test your integration against the new version.
If you use Connect, test your Connect integration.
In Workbench, perform the upgrade. You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.