Adds support for Customer Sessions for the Mobile Payment Element and Customer Sheet
What’s new
Lets you create a Customer Session for Payment Sheet and Payment Method Settings Sheet, which you can use to save a customer’s payment method.
Impact
This enables support for Customer Sessions when saving payment methods in Payment Sheet and Payment Method Settings Sheet. To use the latest features, we recommend updating your integrations to use Customer Sessions instead of customer ephemeral keys.
For example, if your existing integration uses SetupIntents to set up future payments by saving a payment method with an ephemeral key, replace the request to create an ephemeral key:
Command Line
With a request to create a Customer Session:
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
If your existing integration uses PaymentIntents to save payment details during the payment, make the same replacement, following the examples in the guide.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| customer_sheet mobile_payment_element | 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: 2025-10-29. clover
- 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.