Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in

Makes client secret optional for Financial Connections Sessions

What’s new

The client_secret property is now optional on Financial Connections Sessions. Previously, the client_secret property was set on all Financial Connections Sessions. It will only be omitted for sessions created with a ui_mode value of hosted.

Impact

This change is backward compatible. Existing integrations continue to work because the client_secret is still provided for existing Financial Connections flows, and will only be omitted for net-new flows.

Changes

FieldChangeFrom → to
FinancialConnections.Session.client_secretChanged
string → nullable(string)

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-11-17.clover
  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.

Was this page helpful?
YesNo