Adds the ability to query entitlements and launch the customer portal in Customer Sessions
What’s new
Expands the Customer Session object to support the following new components:
- customer _ portal : Redirects a customer to their customer portal from the session so they can manage their subscriptions and payments.
- active _ entitlements : Shows a customer their active entitlements within the customer session.
Impact
You can now create a Customer Session on your server with the customer_portal or active_entitlements components enabled, then pass its client_secret to your client application. A client that holds the client_secret can:
- Retrieve the customer’s active Entitlements to gate access to features in your application.
- Open the Stripe-hosted customer portal for that customer so they can manage their subscriptions, payment methods, and billing information. Your application presents the portal as an in-app sheet or in a browser, and the customer returns to your application when they’re done.
These components don’t change the behavior of the Payment Element. To get started, see Manage subscriptions on iOS.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| customer_portal | Added | CustomerSession#create. components CustomerSession. components |
| active_entitlements | Added | CustomerSession#create. components CustomerSession. components |
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 .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.