Upgrade to Chargebee Package 1.39X
This page provides step-wise instructions, troubleshooting tips, best practices recommendations and offers tools for a successful upgrade.
The entire upgrade process can be divided into two main steps:
Upgrading the package has implications on your data, object relationships, reports, components and others.
Estimated time required
1-2 Hours (may vary based on the data volume to be synced).
It is recommended to perform the upgrade at non-business hours with lesser traffic for easy deployment.
Test the new upgrades on your Sandbox
Install and test out the new version on your sandbox before installing it on the live site. The integration does not support downgrading to the older version of the Chargebee app.
Backup your Data
Perform a full data backup if possible and turn off any triggers temporarily until the upgrade and migration completes.
Turn of auto-sync
Login to Salesforce.org
Reach out to [email protected] to obtain the new package link.
The link initiates the package installation process.
On the Upgrade Chargebee for Salesforce screen, select Install for Specific Profiles and click Upgrade.
This starts the upgrade installation.
After the installation is complete, click Done.
This redirects you to the Installed Package screen on your Salesforce org which shows the details of the package version. For more information on package installation, refer the complete installation guide.
Before migrating your data, ensure that the critical update "Enable improved caching of org" is activated for the organisation.
Follow these steps to ensure that the critical update is activated:
Go to Setup.
On the search box on the left, search Critical Updates.
Look for Enable improved caching of org on the critical update page.
If the setting is not already activated, Click Activate.
Chargebee carefully moves your site settings, field mapping, sync preferences, configurations and data from the old version so you do not have to manually change the settings. Once migrated, the data such as product catalog data, transactional data are resynced to Salesforce.
Ensure that your sites are added as a remote site in the Remote Site Settings page.
Estimated time required: 1-2 hours
To perform the migration, users need to be provided with the ChargebeeForSalesforceAdminUser permissions. [Learn how to assign permission to a user]salesforce-integration-guide.html#prerequisites_assigning-permission-sets target)
On Salesforce dashboard, go to Chargebee Integration, from the app switcher.
This redirects you to migration screen.
Click on Start Migration.
Once your data is migrated for your package is complete, Chargebee sends an email notification to the connected email account.
Turn on the auto-sync
If you are satisfied with the migration, you may turn the auto-sync back on.
Check if the user profile has access to "chargebeeapps.Sync Settings
Add the custom setting to the Enabled Custom Setting Definitions list
Check that the ChargebeeForSalesforceAdminUser Permission Set is assigned
Refer Manage Permission step
CRUD (Create,Read,Update and Delete) permission on :
Read and Update permission for the following field:
Enable activation of improved caching of org
Though the Salesforce for Chargebee app provides detailed description of the errors and their resolutions, if you are having trouble upgrading, reach out to [email protected] . You may also need to grant access to the support team in order for them to guide you better.
In Salesforce Lightning
Click on the profile avatar and go to Settings.
Search for Grant Login Access from the search box.
Set the Access Duration to 3-7 days for ChargebeeInc Support.
In Salesforce Classic
Click on the profile name.
Click on My settings → Personal
Set the Access Duration to 3-7 day for ChargebeeInc Support.
Click on Save.