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.
Related Scenarios
- 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=trueis set, it is returned asfalse. - 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.
Related Articles
Was this article helpful?