Docs

Log into read the version of docs relevant to your site.

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

Problem Statement

You want to change the base currency of your Chargebee site.

Solution

The Multicurrency Pricing feature is required to change the base currency. You need more than one currency added to your site. This feature is available only on selected plans. See Plans and Pricing.

Configuration Steps

For LIVE sites with no data

You can change the base currency only if there are no products, invoices, transactions, or gateways associated with the current base currency.

Navigate to Settings > Configure Chargebee > Currencies (under Billing section).

For LIVE sites with existing data

Step 1: Delete all customers and Product Catalog data (Plans, Add-ons, Coupons), as they are linked to the current base currency.

Important: Deleting customers will delete associated invoices, subscriptions, transactions, and credit notes. This data cannot be regenerated. If you cannot delete the data, create a new Chargebee site (using a different email) and transfer data using bulk operations. Update the new currency in the bulk operation files accordingly.

Step 2: Navigate to Settings > Configure Chargebee > Payment Gateways > Manage rules (under Smart Routing) > Edit. For each payment method, set None for all currencies.

You should now be able to change the base currency.

Step 3: After changing the base currency, go back to Settings > Configure Chargebee > Payment Gateways > Manage rules (under Smart Routing) and map the new currency to the gateway(s).

For help changing your base currency, contact Chargebee support.

Was this article helpful?