Getting Started

Building Blocks

Subscription Features



Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages

Attach Additional Data


Open Source Resources

Other Features

API Integration

Third Party Integrations

Migrating Subscription Data to Chargebee 

To get started, submit a migration request here . Once we receive your request, we will reach out to you with additional questions and details of charges, if any. We will also share a Migration Checklist with you.

Here's a gist of the process:

  1. You should set up your Chargebee test site with the required product configuration (plans, addons, and coupons), email notifications, etc.

  2. We will also need the Subscription data from you in a CSV file. Instructions on sending the data and the format will be sent to you once we receive the migration request.

  3. In the CSV file containing the Subscription data, you should use the exact ids that are in Chargebee for the plans, addons, and coupons.

In Chargebee, you will find the ids under Product Catalog > Plans as shown below:

  1. The Subscription data that you provide will be cleansed and reviewed by us and then by you. Once the data is ready, we will import all the subscriptions into your Chargebee test site for your verification.

  2. In parallel, you need to setup your live site and start signing up new Customers through Chargebee. This is to ensure that you completely tryout the signup flow and to check whether there are new additions to the migration data.

  3. After the you review the data give us the go-ahead, you should cancel all the Subscriptions in your existing system to ensure that the customers are not billed twice.

  4. We will then import the Subscriptions into your live site and Chargebee will take over the billing.


Migrations usually take 5 to 7 business days to complete. This depends primarily on the available migration slots, number of records, data cleansing required, and verification/review iterations.

Is there a chance of double billing?

The migration process ensures that there will be no double billing. First, you will need to stop taking new sign ups through your existing billing platform. This task will be a part of the migration checklist that we will share with you; we cannot proceed with the migration unless this is done.

Next, before the import begins in Chargebee, all the subscriptions in your existing system should be canceled.

As an additional precaution, if there are any subscriptions that have been scheduled to renew on the day of migration, the renewal will be postponed by a few days (usually 2 or 3 days, based on your preference). This gives you sufficient time to review all the data in the live site and make changes if needed before renewals start happening in Chargebee. Say, the migration is scheduled for the 1st of June and a few subscriptions are also scheduled to renew on that date, and you'd like the renewals to be postponed by 2 days, the renewal will happen on the 3rd of June.

Points to note

  • The time required for completing the migration depends largely on the format the data is provided in. The more complicated it is, the more time it takes. We ideally would prefer the data in the exact format given in the migration sheet.
  • You should set up all your plans, addons, coupons, and related configuration in your Chargebee site (both test and live).
  • We do not prefer data transfer happening via emails (as attachments). Google Sheets, Docs is a more preferred/secure way of sharing data.
  • Data manipulation/editing using discretion, even if it's considered a small change, should be done by you.
  • If payment details are also being imported, when mapping the payment details with the imported Subscribers, any unpaid invoices will not be collected and there will not be a payment method validation.
  • The changes done in your live site are irreversible. So you should carefully review all your data before it is imported.
  • Any changes to the data after it's been imported into the test site must be done in the migration sheet used to import the data and not directly to the data present in the test site.
  • The ‘next billing at' dates cannot be in the past. They should be a future date (a date newer than the date/time of migration).
  • It is not possible to edit the plans, addons and coupons in Chargebee once they have subscriptions associated with them.
  • Past invoices and transactions cannot be imported.
  • A Subscription can be associated with only one coupon (when migrating into Chargebee). If there are more than one coupon for a Subscription, it should be added after the import through the web interface in your live site.