How do I remove an additional currency from my Chargebee site?

Problem Statement

You want to remove an additional currency from your Chargebee site. The currency may have been added for testing, may no longer be supported by your business, or may no longer be used for billing.

Solution

You cannot remove an additional currency in the Chargebee user interface. Chargebee Support removes it after you clear every configuration and record associated with it. This procedure applies only to an additional currency. It does not remove your site's base currency. To change the base currency, see How can I change the base currency of my Chargebee site?.

Removing the currency does not convert existing records to another currency. On a live site, export any data you must retain before you delete associated records. If you must keep historical billing data, leave the currency configured and stop creating new price points, customers, or transactions in it. Records deleted in this process might not be recoverable.

1. Review the site for objects that use the additional currency. Depending on your configuration, these can include Plan, Addon, and Charge price points, coupons or discounts, customers and subscriptions, invoices and credit notes, transactions, payments, and refunds, promotional credits, payment gateway or Smart Routing configurations, and other billing records that reference the currency. Use the currency filters on the relevant list pages, and export the records when you need a more complete review.
2. Delete or otherwise remove every record linked to the currency. Where an object cannot be deleted because it has dependencies, resolve those dependencies first. You might need to cancel or delete subscriptions that use the currency, remove the corresponding customers where applicable, delete product price points configured in the currency, resolve and remove invoices, credit notes, transactions, refunds, or credits linked to the currency, and remove currency-specific coupons and other configurations. Deleting billing and financial records can be irreversible and can affect accounting, audit, tax, and reporting. Confirm the impact with your finance or accounting team before you do this on a live site.
3. Go to Settings > Configure Chargebee > Payment Gateways > Manage rules (under Smart Routing).
4. Click Edit.
5. For each payment method, set None for the additional currency.
6. Save the changes. The additional currency is no longer mapped to a gateway. For how currencies are configured, see Multicurrency Pricing.
7. Contact Chargebee Support. Include whether the request is for a test site or a live site, the site domain, the currency code, the business reason for removing the currency, and confirmation that the associated objects and gateway mappings have been removed.

Chargebee Support verifies that no dependencies remain and removes the currency. If products, invoices, transactions, payment gateways, or promotional credits still reference the currency, the removal cannot be completed. Review those areas again and remove the remaining dependencies. If you cannot identify the linked records, share the details with Chargebee Support.

Important Notes

Records that use the currency keep currency-specific billing and financial values. Removing the currency while those records still exist can make the site's data inconsistent.

When historical records cannot be deleted, keep the currency configured and stop using it for new billing activity. Contact Chargebee Support to discuss the options for your site.