Getting Started

Building Blocks

Subscription Features

Custom Fields




Order Management

Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Revenue Recovery


Self-Serve Portal


Reports and Analytics

Data Privacy & Security

Fraud Management


Other Features


Third Party Integrations

Migrating Subscription Data to Chargebee 

To migrate your subscription data to Chargebee, you can raise a request by navigating to Settings > Import & Export Data > Raise a Migration Request > Request Migration.

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. Place a migration request to Chargebee support.
  3. Chargebee support will get back to you with instructions on how to send your subscription data across in CSV format.

Remember, your CSV file must contain the exact Plan ids that correspond to your data in the Chargebee TEST site. 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 Chargebee and then by you. Once the data is ready, all the subscription data is imported 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 data review is done, you should cancel all the Subscriptions in your existing billing system to ensure that the customers are not billed twice.
  4. Subscriptions will be imported into your LIVE site and further billing will be handled by Chargebee.

Migrations usually take 5 to 8 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. To ensure this, you will need to stop new sign ups through your existing billing platform. This task will be a part of the migration checklist that Chargebee shares with you; migration cannot process unless this is done.

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.

How will Chargebee use my past subscription data? 

  • Chargebee will use your past subscription data to record the trial period information of currently active subscriptions.
  • Chargebee will use your past invoice data to handle proration on any active subscriptions that are upgraded or downgraded before their renewal.
  • If you are unable to upload past invoices, Chargebee will use your subscription data to generate sample invoices for past payments. Once you verify that they are accurate, Chargebee will import and use them to handle proration on any active subscriptions.

Your reports from Chargebee will not change in any way after you have imported past subscription data.

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.
Was this article helpful?