← Back
Stripe
Stripe renames Embedded Checkout initialization method to createEmbeddedCheckoutPage()
Stripe APIStripe · breaking-changeapisdk · docs.stripe.com ↗

Breaking Change: Embedded Checkout Method Renamed

Stripe has renamed the stripe.initEmbeddedCheckout() method to stripe.createEmbeddedCheckoutPage() as part of a broader API cleanup. The options and return type remain identical—only the method name has changed.

What Developers Need to Do

If your integration uses Embedded Checkout, you must update your code immediately. Calling the old initEmbeddedCheckout() method will throw an IntegrationError.

Before:

const checkout = await stripe.initEmbeddedCheckout({fetchClientSecret});

After:

const checkout = await stripe.createEmbeddedCheckoutPage({fetchClientSecret});

Related API Changes

This rename is part of a larger Stripe.js update that includes:

  • Removal of deprecated Payment Intents, Setup Intents, and Sources methods
  • Updates to the Address Element state field formatting (now defaults to Latin characters)
  • Changes to the Payment Element's future usage configuration
  • elements.update() method now returns a Promise
  • Removal of boolean value support in options.layout.radios
  • Rename of Checkout initialization method (initCheckout() to initCheckoutElements())

Review the Stripe.js documentation for complete migration details.