Skip to content

Versioning

Previous versions

Upgrade your API version

Upgrade your SDK version

Essentials

Sample projects

Tools

Developers Dashboard

Stripe for Visual Studio Code

Features

Event Destinations

Stripe health alerts File uploads

AI solutions

Security and privacy

Extend Stripe

Build Stripe apps

Use apps from Stripe

Partners

Partner ecosystem

Partner certification

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_daysweekly_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.