Adds a customer update deep link for billing portal sessions
What’s new
Adds customer_update as a value for the flow_data.type parameter when you create a billing portal session. Setting this value creates a deep link that navigates your customer directly to the billing information page in the customer portal, where they can update their details. This is consistent with existing deep-link flow types such as payment_method_update, subscription_cancel and subscription_update.
Impact
You can now create billing portal sessions that link customers directly to the billing information update page by setting flow_data.type to customer_update. No changes are required for existing integrations.
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| customer_update | Added | BillingPortal. Session. flow |
| Value | Change | Enums |
| customer_update | Added | BillingPortal. Session#create. flow_data. type BillingPortal. Session. flow. type |
Upgrade
- View your current API version in Workbench.
- 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: 2026-08-26. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.