When managing subscriptions in Chargebee, you may encounter a situation where you need to replace an existing Addon ID across multiple subscriptions. Since Addon IDs are immutable in Chargebee, you cannot directly update them. However, you can replace the old Addon with a new one using Chargebee's Bulk Operations feature. This article provides a step-by-step guide to perform this operation efficiently.

Solution

Follow these steps to replace an Addon ID across multiple subscriptions:

1. Create a New Addon:

   • Navigate to Product Catalog > Addons in your Chargebee Billing site.
   • Click Create Addon and configure the new Addon with the desired settings.
   • Click Save to save the newly created Addon.

2. Export Subscriptions Using the Old Addon:

   • Go to Subscriptions in your Chargebee Billing site.
   • Use the filter option to find subscriptions that include the old addoon.
   • Export the list of these subscriptions to a CSV file by clicking Export.

3. Prepare the Bulk Update CSV File:

   • Open the exported CSV file and add a new column for the new addon ID.
   • Populate this column with the ID of the new addon you created.
   • Ensure that each row corresponds correctly to the subscription that needs updating.

4. Perform the Bulk Update:

   • Navigate to Bulk Operations.
   • Select Import Subscriptions and upload your prepared CSV file.
   • Follow the prompts to map the CSV columns to the appropriate fields in Chargebee.
   • Review the changes and confirm the bulk update.

Important Notes

• Immutable IDs: Remember that Addon IDs cannot be changed once created. Always plan your Addon IDs carefully.
• Backup Data: Before performing bulk operations, ensure you have a backup of your data.
• Test in Sandbox: If possible, test the bulk update process on your TEST site to ensure accuracy.
• Monitor Changes: After the bulk update, monitor the affected subscriptions to confirm that the new addon ID has been applied correctly.