Multi Business Entity Transfer Configuration 

The Multi-Business Entity feature enables you to create multiple independent entities within a single Chargebee site. This solution is built to ensure you can manage each of your business entities as you would with an independent Chargebee site. However, creating multiple entities also requires you to configure each of the settings individually, which can be repetitive and time-consuming.

The Multi Business Entity Transfer Configuration tool is designed to help you transfer settings specific to a business entity from a Chargebee site or other entities configured previously seamlessly and quickly. In addition to the time saved from configuring each entity individually, you can also choose to customize the configurations to transfer.

It is recommended to complete the Transfer Configuration individually for your Live and Test sites. The configuration transfer completed on your Test site will not apply to your Live site and vice-versa.


The following prerequisites must be met before using this feature:

  • Update the Organization Address for your Chargebee site before enabling the Multi Business Entity feature.
  • The Multi Business Entity feature is available to sites in Product Catalog 2.0 only.
  • Enable the Multi Business Entity for the site from which you choose to transfer configurations.
  • Initiate Configuration transfer from a site to an entity and not vice-versa.
  • The transfer of configurations is limited to settings that can be overridden at an entity level:
    • Invoice, Quotes, and Credit Notes
    • Smart Routing for payment processing
    • Tax Registration Numbers
    • Tax Validation Option
    • Third Party Tax Config
    • Signatures
  • The settings to be transferred must be configured at a site level prior to initiating a transfer to an entity.

Transfer of Configuration 

Complete the following steps to transfer configurations from your site to an entity:

  1. Login to your Chargebee site.

  2. Navigate to Settings > Configure Chargebee > Transfer Configurations for Multi Entity.

  3. Select the applicable site or entity from the SOURCE drop-down list.

  4. Select the entity to transfer the configuration from the DESTINATION drop-down list.

    Note: Click New entity to create a new entity that is not listed in the drop-down list.

  5. Click Add another transfer to transfer configurations to multiple entities.
    Note: You can transfer to a maximum of five(5) destination entities at a time.

  6. Click Proceed.

  7. Review the configurations to be transferred in the Transfer Configurations Multi-Entity Setup screen.

  8. Uncheck an applicable checkbox to skip a configuration from being transferred.
    Note: You cannot customize configurations for an entity individually when more than one entity is part of a transfer from this screen. This can be done once the transfer validation is complete as in Step 10.

  9. Click Validate.
    Note: The validation check can take a few minutes, it is recommended to wait while this completes

  10. Review the configuration details after successful validation and click Finalize transfer.

  11. Click Confirm to initiate the configuration transfer.
    Note: This transfer can take several minutes to complete, you can continue to wait or continue to work on your Chargebee site uninterrupted.

The configuration transfer is now complete and the changes will appear within the selected destination entity.

Transfer Error Validation 

The validation process reviews the availability of the configuration and ability prior to initiating the transfer process.

  • The validation stage highlights the errors that must be resolved prior to the successful transfer. These errors can be viewed across individual entities if you have selected multiple entities.
  • Select Uncheck all settings with errors to skip the parameters with errors and continue with the transfer.
  • Skip any configurations that are identical to the source site.
  • Click Start over to reinitiate the transfer configuration process.

Transfer Configuration History 

You can also review the historical details of the transfer configurations completed previously. While the default view includes previous three transfers, Click Show More to view more transfers.

Follow the steps below to view the Transfer Configuration History:

  1. Access the Transfer Configuration for Multi Entity tool.

  2. The historical list of transfers completed is displayed. Click Show All for a detailed view of the configurations transferred.

Was this article helpful?