Renames the parameter for custom settlement timing on the Balance Settings APIBreaking changes
What’s new
This change renames the top-level delay_
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_
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_
, we apply default settlement timing.
Why is this a breaking change?
We renamed the delay_
parameter to delay_
.
Impact
If you participate in the Accounts v2 API public preview and want to use API version 2025-07-30.
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_
, update your Balance Settings integration to use the delay_
parameter.