Adds support for Customer Sessions for 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, replace the request to create an ephemeral key:

curl https://api.stripe.com/v1/ephemeral_keys \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -H "Stripe-Version: 2026-01-28.clover" \
  -X "POST" \
  -d "customer"=
{{CUSTOMER_ID}}
 \

With a request to create a Customer Session:

curl https://api.stripe.com/v1/customer_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "components[mobile_payment_element][enabled]"=true \
  -d "components[mobile_payment_element][features][payment_method_save]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_redisplay]"=enabled \
  -d "components[mobile_payment_element][features][payment_method_remove]"=enabled

If your existing integration uses PaymentIntents to save payment details during the payment, make the same replacement, following the examples in the guide.

Changes

Upgrade