How to move a subscription from one customer to another?

Problem Statement

You want 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: Combine two customer records and move all subscriptions under a single customer.
• Move a subscription API: Move one or more subscriptions from one customer to another without merging the customer records.

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. See the Merge customers API documentation for details.
• The Merge customers API moves the following 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 to enable it for your site.
• Limitations:
  • Events and email logs are not moved
  • Virtual bank accounts cannot be moved between customers
  • When using Merge customers API, all subscriptions of the source customer are moved to the target customer
  • With third-party accounting (e.g., Xero), the subscription may remain mapped to the original customer record after moving