Docs

Log into read the version of docs relevant to your site.

V3 hosted page in an iframe is not supported

Problem Statement

This article explains why the v3 In-app checkout cannot be embedded in an iframe and why the embed parameter is forced to false.

  • Embed value defaults to false even when embed=true is set
  • Using Chargebee In-app checkout in an iframe

Solution

The v3 checkout modal is already an iframe. Embedding it inside another iframe creates nested iframes and a poor UX (customers must scroll to see the full checkout). To avoid this, Chargebee forces embed to false when you try to use this setup.

Note:

  • The checkout version is site-specific; you can use only one checkout type per site.
  • When embed=true is set, it is returned as false.
  • With embed=false, gateways like PayPal and GoCardless that use redirect flows are supported.

Tip: Use the latest Chargebee checkout version to reduce manual handling of multiple subscriptions under the same record.

For more information, contact Chargebee Support.

Was this article helpful?