Adds more flexible schedules for monthly and weekly payouts
What’s new
The payout schedule for an Account is defined in settings.payouts.schedule.
- If the interval is monthly , you can now specify when a payout should happen using monthly_payout_days .
- If the interval is weekly , you can now specify when a payout should happen using weekly_payout_days .
Impact
You can now customize your payout schedule by selecting multiple payout days in a week or month. This gives you fine-grained control over when you receive your payouts.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| monthly_payout_days weekly_payout_days | Added | Account#create. settings. payouts. schedule Account#update. settings. payouts. schedule Account. settings. 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-06-30. basil
- 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.