This guide is for users upgrading from the public beta of the new version of Checkout.

If you are using the Checkout client integration, you can tell that you are using a beta version if you were passing betas: ['checkout_beta_4'] (or checkout_beta_3 or checkout_beta_2 ) when initializing Stripe.js.

If you are using the Checkout server integration, you are using a beta version if you are passing checkout_sessions_beta=v1 as Stripe API version when initializing your Stripe API bindings.

Your beta integration will continue to work, but we recommend that you make the changes outlined below as soon as you can.

Integration Changes

var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx', {
  betas: ['checkout_beta_4']
});

stripe.redirectToCheckout({
  // Your configuration options.
}).then(function (result) {
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `result.error.message`.
});

var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

stripe.redirectToCheckout({
  // Your configuration options.
}).then(function (result) {
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `result.error.message`.
});

Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Stripe.api_version = '2018-11-08; checkout_sessions_beta=v1'

Stripe::Checkout::Session.create({...})

Stripe.api_key = 'sk_test_4eC39HqLyjWDarjtT1zdp7dc'

Stripe::Checkout::Session.create({...})

var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx', {
  betas: ['checkout_beta_4']
});

stripe.redirectToCheckout({
  sessionId: sessionId,
}).then(function (result) {
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `result.error.message`.
});

var stripe = Stripe('pk_test_TYooMQauvdEDq54NiTphI7jx');

stripe.redirectToCheckout({
  sessionId: sessionId,
}).then(function (result) {
  // If `redirectToCheckout` fails due to a browser or network
  // error, display the localized error message to your customer
  // using `result.error.message`.
});

Payment Methods instead of Sources

The beta version of Checkout created a Source, whereas Checkout now creates a PaymentMethod. This change affects you if you were relying on the sources property of the Customers or on the source property of PaymentIntents.

You can learn more in the Payment Methods API migration guide.

Webhook Changes

We will continue to send the checkout_beta.session_succeeded event, but we suggest you migrate to handling the checkout.session.completed event instead. The checkout.session.completed webhook includes the Checkout Sessions object.

For more details about handling purchase fulfillment with Checkout, refer to the documentation.

Subscription and Customer Changes

Migrating off of the Checkout beta slightly changes the behavior of the Subscriptions that Checkout creates.

The beta version of Checkout created a Source and set it as the default_source on the Customer it created. After the migration, Checkout will create a PaymentMethod and set it as the default_payment_method on the Subscriptions it creates.

In the beta version of Checkout, successful Checkout Sessions for subscriptions had a value for both the payment_intent and subscription properties. After the migration, successful Checkout Session objects for subscriptions will only have a value for the subscription property, and the payment_intent property will be blank. If you still want to access the payment details for the first invoice, you can use session.subscription.latest_invoice.payment_intent.