{
  "slug": "stripe-financial-connections-sessions-add-explicit-configuration-options-c6427339e4c7",
  "title": "Stripe Financial Connections sessions add explicit configuration options",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-07-29T00:00:00.000Z",
  "announced_at": "2026-07-29T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When a session must tailor collected accounts or the authentication fallback, create it with `filters.require_payment_method_support`, `limits.accounts`, and `manual_entry.mode` as needed. After manual entry, use the returned `bank_account_token`; subscribe to the eligibility update event when you need notice of confirmed payment eligibility.",
    "examples": [
      "curl https://api.stripe.com/v1/financial_connections/sessions \\\n  -u \"<SECRET_KEY>:\" \\\n  -H \"Stripe-Version: 2026-07-29.dahlia\" \\\n  -d \"account_holder[type]\"=customer \\\n  -d \"account_holder[customer]\"=<CUSTOMER_ID> \\\n  -d \"permissions[]\"=payment_method \\\n  -d \"filters[require_payment_method_support]\"=at_least_one \\\n  -d \"limits[accounts]\"=<MAX_ACCOUNTS> \\\n  -d \"manual_entry[mode]\"=automatic",
      "curl https://api.stripe.com/v1/webhook_endpoints \\\n  -u \"<SECRET_KEY>:\" \\\n  -d \"url\"=<WEBHOOK_URL> \\\n  -d \"enabled_events[]\"=financial_connections.account.supported_payment_method_types_updated"
    ],
    "gotchas": [
      "Version: 2026-07-29.dahlia",
      "filters.require_payment_method_support: Restricts account selection: `all` makes every linked account payment-eligible; `at_least_one` makes at least one payment-eligible while allowing others; `none` imposes no restriction.",
      "limits.accounts: Maximum number of accounts a user can link in a session.",
      "manual_entry.mode: Controls manual bank entry fallback: `automatic` lets Stripe manage it; `disabled` removes the option. These values are alternatives.",
      "bank_account_token: Returned on the Session object when the user completes manual entry.",
      "enabled_events[] (required): Webhook event types to enable; include `financial_connections.account.supported_payment_method_types_updated` for payment eligibility notifications.",
      "Prerequisite: For the new options, use API version `2026-07-29.dahlia`; Stripe says to upgrade SDKs to the corresponding version if used, or send the `Stripe-Version` header for direct API requests. Upgrade the webhook endpoint API version as well.",
      "`filters.require_payment_method_support` accepts `all`, `at_least_one`, or `none`.",
      "`manual_entry.mode` accepts `automatic` or `disabled`.",
      "`bank_account_token` is returned when a user completes manual entry."
    ]
  },
  "why_it_matters": "Configure a Financial Connections session to collect accounts and handle authentication according to the integration’s use case.",
  "before": "Session behavior was implicitly determined by account holder type.",
  "sources": [
    "https://docs.stripe.com/changelog/dahlia/2026-07-29/financial-connections-advanced-session-config",
    "https://docs.stripe.com/api/webhook_endpoints/create?api-version=2026-07-29.dahlia"
  ],
  "rank": 0.94037,
  "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-2764a63bcb73a25d-0:gate",
    "evidence_hash": "939fd269bbc9303655549fa25004d33c04aabf80283e362dfb788d42685a5cdb"
  },
  "review": {
    "draft_hash": "ea0c349f105e3d04a6f62c82abe70fa437261298721af30925e5731b2dcf9f27",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.94 >= 0.9; 2 needed) and Jev gave 0.77 (>= 0.6 needed)."
  }
}