How to move a subscription from one customer to another?

Problem statement

This article explains how to move an existing subscription from one customer record to another in Chargebee.

Solution

Chargebee provides two ways to move subscriptions between customers:

• Merge customers: Use this option to combine two customer records and move all subscriptions under a single customer.
• Move a subscription API: Use this API to move one or more subscriptions from one customer to another without merging the customer records.

You can choose the approach based on whether you want to consolidate entire customer data or move only specific subscriptions.

Additional information

• If Account Hierarchy is enabled, the Merge customers API does not work. For details, see the Merge customers API documentation.
• The Merge customers API moves the following data from one customer to another:
  • Payment methods
  • Subscriptions
  • Invoices
  • Credit notes
  • Transactions
  • Unbilled charges
  • Orders
• The Move a subscription API is not enabled by default. Contact Chargebee Support at enable it for your site.
• The following limitations apply:
  • Events and email logs are not moved.
  • Virtual bank accounts cannot be moved between customers.
  • When using the Merge customers API, all subscriptions of the source customer are moved to the target customer.
  • If you use a third-party accounting system such as Xero, the subscription may continue to remain mapped to the original customer record even after moving it.