Getting Started

Product Catalog



Invoices, Credit Notes and Quotes



Site Configuration

Data Privacy & Security

Data Operations

Reports and Analytics


In-App Checkout 

In-app is a intuitive pop up style checkout. On clicking the Subscribe/Checkout button, a pop up would open where your customers will have to enter their account and payment details. You can choose to configure your brand elements, fields, display charges, taxes, a thank you message and play around with multiple workflows to suit your business needs!

Here is a sample of the In-app Checkout.

Users signing up from Feb 06, 2018 will have In-app checkout enabled by default. In case you are using the single page Checkout and wish to try In-app checkout, please watch the below video.


This is applicable only in Test Site. Please contact [email protected]  to enable it in the Live Site.


Before you configure In-app checkout, please make sure that you:

  • Create Plans: Create the necessary plans in Chargebee. You can create a plan by clicking Product Catalog > Plans > Create New Plan. Learn more.
  • Configure a Payment Gateway: Configure a payment gateway of your choice to process your payments. You can connect with gateways like Stripe,, Braintree, Amazon Payments etc. You can configure a payment gateway of your choice by clicking Settings > Configure Chargebee > Payment Gateways > Add Gateway. Learn more about configuring payment gateways.
  • Configure Brand Style: Configure your brand elements such as logo and brand color. These elements will appear on your checkout screen. You can configure your brand elements by selecting Settings > Configure Chargebee > Brand Styles. Learn more about branding.

Options to set up In-app Checkout 

As a merchant, depending on your business model, you can choose how you'd like to set up the Checkout. Chargebee provides you with three options to choose from.

  • Drop in Script to open In-app inside your own app
  • Create a plan specific URL
  • Use API (applicable if you want to handle returning users, collect partial information at your end, authenticate the user at your end etc)

Drop-in Script 

Drop in Script is an easy to use plug-in modal that requires zero developer help. You can easily create a checkout page by adding a script generated for the plan in your HTML page.

Checkout pages generated using drop in script are Level 1 PCI compliant and all that you have to do is fill in this questionnaire.

To use the drop in script to create checkout pages:

  • Click Settings > Configure Chargebee > Checkout and Self serve portal > Integrate with Chargebee
  • Select the Plan and Add on from the drop down.
  • Copy the Header script and paste it within the tags of the HTML page.
  • Copy the Checkout Button code and paste it in the body of the HTML page.

Here is a sample checkout.

Creating Plan specific URL 

You can manually create a checkout URL and embed it in your application/website's checkout button. On click of the checkout button, In-app Checkout is displayed.

Here's the syntax to create a plan specific URL:


Replace the "site-name" and "plan-id" placeholders with your Chargebee site name and Plan ID. For example if the site name is ‘docstest-test' and plan ID is 'sapphire' then this is how the URL would look:

This approach is recommended if your application/website's code does not accept JS scripts.

Checkout via API 

Checkout via API is extremely useful when you want to have a user management or authentication system at your end.

Here is a quick example when you'd want to choose Checkout via API instead of Drop in script.

Let us assume that James runs a digital weight loss and fitness app. He wants to collect user information such as the client's height, weight, food habits etc along with his address, email and store it in his database instead of Chargebee. But, he would still like to use Chargebee's checkout as he does not want to get involved in the nitty-gritty details of PCI Compliance.

James can choose the API integration as this would allow him to collect partial information at his end and then use Chargebee Checkout API to collect the remaining information (Specifically payment details for example). Chargebee will take care of the PCI Compliance, all that James has to do is fill in this questionnaire.

Benefits of using API integration:

  • Allows you to manage authentication, collect partial information in your app or website etc
  • Allows you to override plans and add-ons pricing during checkout itself.
  • Optimize trial tenure. This allows you to customize the trial tenure based on the customer (for example: You can offer a 14 day trial to one customer, and a one month trial to another customer)

Checkout via API would require developer efforts from your end. Please refer to this documentation to learn more.

3DS Payments via In-app Checkout 

Chargebee's In-app Checkout supports 3DS payments. All you need to do is complete our SCA checklist, and Chargebee will start handling 3DS payments via In-app Checkout.

For scenarios which do not involve immediate payment like Update Payment Method, Subscription with trial etc., Chargebee performs minimum amount 3DS authorization. This ensures that subsequent payments can mostly go through without customer intervention. The authorized amount will be voided automatically.

For scenarios which involve immediate payment as in Subscription without trial, Upgrade Subscription etc., Chargebee takes care of initiating the 3DS flow and allowing 3DS verification to happen.

Was this article helpful?