New in Chargebee: Explore Reveal and understand your payment performance end-to-end.Try Now

Docschargebeedocs

HomeBillingPaymentsRevRecGrowthReveal
Support

Product Updates


  • Release Notes

Getting Started


  • Overview
  • Chargebee Billing Data Centers
  • Object Relationship Model
  • Understanding Sites
  • Developer Resources
  • Chargebee Tech Glossary
  • Articles and FAQ

Implementing Chargebee


  • Implementation Guide
  • Go-live Checklist
  • Articles and FAQ

AI in Chargebee


  • Chargebee Agents
  • Chargebee Copilot
  • Chargebee MCP Server (Model context protocol)

Product Catalog


  • Product Catalog Overview
  • Coupons
  • Articles and FAQ

Subscriptions


  • Working with Subscriptions
  • Billing
  • Orders
  • Articles and FAQ

Customers


  • Managing Customers
  • Account Hierarchy
  • Email Notifications
  • Branding
  • Configure Multiple Languages
  • Articles and FAQ

Invoices, Credit Notes and Quotes


  • Invoices
  • Credit Notes
  • Quotes [Legacy]
  • Transactions
  • Articles and FAQ

Taxes


  • Overview
  • Configuring Taxes
  • Country-specific Taxes
  • Articles and FAQ

Hosted Capabilities


  • Overview
  • Hosted Checkout
  • Hosted Self-Serve Portal
  • Hosted Pages Features
  • Additional Hosted Pages
  • Payment Components
  • Managing payments with ChargebeeJS
  • Mobile-Optimized Hosted Pages
  • Articles and FAQ

Site Configuration


  • Users & Roles
  • Custom Fields & Metadata
  • Mandatory Fields
  • File Attachments & Comments
  • Advanced Filter Options
  • Multicurrency Pricing
  • Multi-decimal Support
  • Configuring Reason Codes
  • Events and Webhooks
  • API Keys
  • Time Zone
  • Time Machine
  • Transfer Configurations
  • Articles and FAQ

Reports and Analytics


  • RevenueStory
  • Home Dashboard
  • Frequently Asked Questions
  • FAQs for Classic Reports Sunset
  • Articles and FAQ

Integrations


  • Sales
  • Customer Support and Success
  • Finance
  • Tax
  • Marketing
  • Stitch
  • Collaboration
  • Contract Management
  • Order Management
  • Mobile Subscriptions (Legacy)
  • Other Integrations
  • Articles and FAQ

Data Privacy & Security


  • Two Factor Authentication
  • SAML Single Sign-On
  • System for Cross-Domain Identity Management (SCIM)
  • EU-GDPR
  • Consent Management
  • Personal Data Management
  • Compliance Certificates
  • HIPAA Guidelines
  • PCI Recommendations and Integration Types
  • Articles and FAQ

Data Operations


  • Bulk Operations
  • Migration
  • Articles and FAQ
  1. Billing
  2. Site Configuration
  3. Articles and FAQ
  4. Currencies
  1. Billing
  2. Site Configuration
  3. Articles and FAQ
  4. Currencies

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).

Currencies configuration in Configure Chargebee

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.

Edit payment gateway rules for Smart Routing

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.

Related Articles

What are Zero decimal currencies?

Was this article helpful?