{
  "slug": "balance-settings-api-configures-connected-account-start-of-day-910b6a246fc0",
  "title": "Balance Settings API configures connected-account start_of_day",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-05-27T00:00:00.000Z",
  "announced_at": "2026-05-27T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "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.",
    "examples": [
      "curl https://api.stripe.com/v1/balance_settings \\\n  -u \"<YOUR_SECRET_KEY>:\" \\\n  -H \"Stripe-Account: <CONNECTED_ACCOUNT_ID>\" \\\n  --data-urlencode \"payments[settlement_timing][start_of_day][timezone]=<SUPPORTED_TIME_ZONE>\" \\\n  -d \"payments[settlement_timing][start_of_day][hour]=<HOUR>\" \\\n  -d \"payments[settlement_timing][start_of_day][minutes]=<MINUTES>\""
    ],
    "gotchas": [
      "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."
    ]
  },
  "why_it_matters": "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": "Connected accounts used the same start-of-day time as their platform.",
  "sources": [
    "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"
  ],
  "rank": 0.91016,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-tools-20261017",
    "verdict_id": "wave1b-tools-20261017:wave1b-tools-20261017-52f78401c278f1f9-0:gate",
    "evidence_hash": "c368c56f154a4de47d946c5387c67450eb4006cb2e99563df563b24db2398200"
  },
  "review": {
    "draft_hash": "4d64e7caa4df76db9b209ef995b2aef742b2eb6ef6b4e01781da7668e51557d8",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.91 >= 0.9; 2 needed) and Jev gave 0.68 (>= 0.6 needed)."
  }
}