- Breaking changes
- Public preview
Updates schedule customization for weekly and monthly payouts Breaking changes Public preview
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_anchorto monthly_payouts_days, which can now configure multiple days of the month for payouts. - We’ve renamed
weekly_anchorto 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_days weekly_payout_days | Added | BalanceSettings#update. payouts. schedule BalanceSettings. payouts. schedule |
| monthly_anchor weekly_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.