Balance Settings API configures connected-account start_of_day
Introduced 2026-05-27 · score 0.91
HOW TO USE IT
For an eligible connected account, set `payments[settlement_timing][start_of_day]` when updating its Balance Settings to define the local cutoff used for automatic payout grouping. Use a supported time zone and an allowed hour for the account’s country.
curl https://api.stripe.com/v1/balance_settings \
-u "<YOUR_SECRET_KEY>:" \
-H "Stripe-Account: <CONNECTED_ACCOUNT_ID>" \
--data-urlencode "payments[settlement_timing][start_of_day][timezone]=<SUPPORTED_TIME_ZONE>" \
-d "payments[settlement_timing][start_of_day][hour]=<HOUR>" \
-d "payments[settlement_timing][start_of_day][minutes]=<MINUTES>"WHY THIS HELPS
When aligning a connected account’s payment availability and automatic payout bundling with its local business hours, update that account’s balance settings with a custom daily cutoff.
BEFORE THIS CHANGE
Connected accounts used the same start-of-day time as their platform.
REQUIREMENTS AND LIMITATIONS
- Availability: Currently only available for connected accounts in certain countries.
- Stripe-Account (required): Connected account ID for the Balance Settings update.
- payments[settlement_timing][start_of_day][timezone] (required): Time zone for the custom day; use one supported for the connected account’s country.
- payments[settlement_timing][start_of_day][hour] (required): Start-of-day hour, within the allowed range for the selected time zone and country.
- payments[settlement_timing][start_of_day][minutes] (required): Start-of-day minutes.
- Prerequisite: Feature is available for connected accounts in AU, HK, ID, IN, JP, MY, NZ, SG, and TH; it is in private preview for US connected accounts.
- Prerequisite: Use the connected account’s supported time zone and allowed start-of-day hour range documented for its country.
- Applies per connected account.
- Country availability is restricted to certain countries; the source does not enumerate them.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/dahlia/2026-05-27/custom-start-of-day
- https://docs.stripe.com/connect/customized-start-of-day
- https://docs.stripe.com/api/balance-settings/update?api-version=2026-05-27.dahlia
Check the installed version and the source before using it. Entry JSON