How can I change the base currency of my Chargebee site?

Modified on: Tue, 17 Dec, 2024 at 10:49 AM

Note: The Multicurrency Pricing feature is needed to be able to change the base currency since you need more than one currency added to your Chargebee siteThis feature is only available on selected plans. To know more, visit Chargebee's Plans and Pricing page.

For LIVE sites with no data


You can only change the base currency if there is no data (Product Catalog, Subscriptions, Invoices, Transactions, etc.) and gateways associated with the base currency of your site. 


To change the base currency, go to Settings (on the left panel) > Configure Chargebee > Currencies (in the Billing section) as seen below:


Image 1:



For LIVE sites with related currency data


Step 1: If you do have existing data in your live site, first delete all the customers and the data under the Product Catalog (Plans, Add-ons, Coupons). This is because all of these are linked to the current base currency of your site.


Note: Deleting customers will delete the associated invoices, subscriptions, transactions, credit notes. And it wouldn't be possible to regenerate this data in your Live site. So if you're not okay with deleting the data, the only way is to create a new Chargebee site (using a different email address). You can transfer the existing site's data to the new one using bulk operations. Update the new currency wherever applicable in the files you will be using to carry out the bulk operations.


Step 2: Go to Settings (on the left panel) > Configure Chargebee > Payment Gateways (in the Billing section) > Manage rules (on the right panel, under Smart Routing) > click on Edit (shown in the image below) > select None, for all the currencies under each payment method.


Image 2:



You should be able to change the base currency now. 


Step 3: After you change the base currency in your site, go back to Settings > (on the left panel) > Configure Chargebee Payment Gateways (under Billing section) > Manage rules (on the right panel, under Smart Routing) and map the new currency with the gateway(s).


For TEST sites:


Navigate to Settings > Configure Chargebee > Currencies




Once you click on Change, you will then get a notification with a warning message of what actions will be performed upon changing the base currency.


Changing the base currency will lead to 

  • Clearing your Smart Routing rules
  • Clearing all your site data such as plans, subscriptions, settings, etc
  • Clearing all additional currencies and exchange rate settings


Once you will agree to the conditions and click 'Proceed' you will see the progress status of clearing the data.


Once all the mentioned data is cleared, you will get an option to choose your site base currency. 


Note: Changing the base currency has to be done with caution. The base currency is your site's default currency and as you know changing the base currency will also be updated on all the reports, also affects the calculation of exchange rates as well. 


If you need help changing your base currency, contact Chargebee support.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.
×