Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
Overview
Versioning
Changelog
    Overview
    Basil
    Acacia
    Previous versions
Upgrade your API version
Upgrade your SDK version
Essentials
SDKs
API
Testing
Stripe CLI
Sample projects
Tools
Workbench
Developers Dashboard
Stripe Shell
Stripe for Visual Studio Code
Features
Workflows
Event destinations
Stripe health alertsFile uploads
AI solutions
Agent toolkit
Model Context Protocol
Security and privacy
Security
Privacy
Extend Stripe
Build Stripe apps
Use apps from Stripe
Partners
Partner ecosystem
Partner certification
HomeDeveloper resourcesChangelogBasil2025-07-30.preview

Renames the parameter for custom settlement timing on the Balance Settings APIBreaking changes

What’s new

This change renames the top-level delay_days parameter of the Balance Settings API to delay_days_override to clearly distinguish between Stripe’s default settlement timing and whether your platform requests to override that computed delay.

Platforms can request a specific delay_days_override by creating or updating Balance Settings. Stripe uses the request to determine the final number of days to hold charge funds before they become available. If your platform doesn’t explicitly request a delay_days_override, we apply default settlement timing.

Why is this a breaking change?

We renamed the delay_days parameter to delay_days_override.

Impact

If you participate in the Accounts v2 API public preview and want to use API version 2025-07-30.preview or later, you need to update your integration to use the new parameter name.

If your integration relies on the ability to specify your own settlement timing with delay_days, update your Balance Settings integration to use the delay_days_override parameter.

Changes

ParametersChangeResources or endpoints
delay_days_overrideAdded
BalanceSettings#update.settlement_timing
delay_daysRemoved
BalanceSettings#update.settlement_timing

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: 2025-07-30.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.

Related changes

  • Adds Account Links v2 API support for connected accounts created using the Accounts v2 API
  • Updates schedule customization for weekly and monthly payouts
  • Adds Connect embedded component for Instant Payouts promotion
Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Join our early access program.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc