Getting Started

Building Blocks

Subscription Features



Billing Features


Payment Methods

Direct Debit Payments

Configuring Gateways

Fraud Management

Hosted Pages

Attach Additional Data


Open Source Resources

Other Features

API Integration

Third Party Integrations

Multicurrency Pricing 

Chargebee's Multicurrency feature provides you with the option of creating Plans in multiple currencies, thus allowing your customers to pay in their local currency.


If you are an API user, this feature requires you to pass the currency_code input parameter for some of our API methods before enabling it on your Chargebee site, failing which errors will occur. To be able to do this you need to upgrade to API version V2  if you are on our older version.

Configuring Multicurrency 

The base currency will be your default currency, and will also be used as your reporting currency. Foreign currencies that you transact in will be your Additional Currencies.

Follow the steps below to configure additional currencies in your site.

1. Adding Currencies

  1. Go to SettingsSite SettingsCurrencies and click the Enable under Multicurrency Configuration
  2. Click Add a Currency
  3. Select the required currency and exchange rate. Use one of the following exchange rate types based on your requirement:
  • Manual - Use this option to specify the exchange rate yourself and also schedule rate changes.
  • Auto - Use this option to let Chargebee set the exchange rate. Chargebee will automatically update the exchange rates based on the information received from third party exchange rate providers.

The currencies that you've added will appear under the section Additional Currencies. You will have the option to schedule a change in the exchange rate of a currency, and also update existing rates.

Note on exchange rates

Transactions made in the additional currencies will be converted to the base currency using the exchange rates that you configure in them, for reporting purposes. Learn more.

If you choose Auto as the Exchange Rate Type, Chargebee uses the exchange rates available with currencylayer  and Open Exchange Rates .

Here's how Chargebee picks exchange rates:

If today is 4th August 2016,

  • The previous day's (3rd August 2016) closing rates will be synced with Chargebee from the exchange rate sources.
  • The synced rates will be used for transactions occurring from 00.30 UTC onwards.
  • For transactions occurring before 00.30 UTC, Chargebee will use the closing rates from 2nd August.
  • If Chargebee fails to sync with the exchange rate sources on 4th August 2016, the last available exchange rates will be used.
  • For transactions dated prior to 2011, the closest available exchange rate for 2011 will be used for conversion.

Gateways and Multicurrency Support

  • Currently, Chargebee provides you with the option to configure only one account per gateway. Ensure that your gateway supports the required currencies for a single account. E.g. Stripe supports transactions in multiple currencies with just one account.

  • Certain gateways like Braintree, Authorize.Net, etc. require you to configure separate Merchant IDs for each of the currencies you'd like to transact in. Currently, Chargebee supports only base currency transactions for these gateways. However, we will support multiple accounts with subsequent product updates. If you have any questions in the meanwhile, please write to 

2. Setting up your Product Catalog

The additional currencies that you've set up will appear for selection when you create your Plans/Addons/Coupons.

If you offer the same Plan in various currencies, you need to create the Plan for each of the currencies. This can be easily achieved using the Clone Plan option.

  • For coupons, the option to set currencies will appear only when you set the Discount Type to Fixed Amount.
  • If you want to link a Plan/Addon to a Coupon, both need to have the same currency configured.


The currency of the Subscription depends on the Plan you select while creating the Subscription.
Invoices generated for the Subscription will be in the same currency too.

  • You will not be able to change the currency for existing subscriptions. If you want to change the currency for a Subscription, you need to cancel it and create a new one with the required currency.
  • The currency of the Subscription created via a Hosted Page checkout will be based on the currency of the Plan selected by the Customer.


You can have credits, payments, invoices, and subscriptions of multiple currencies for your Customers.

The currencies that you've set up will appear for selection when you add/deduct credits or payments.

In the case of applying credits or payments on invoices, the currency of the credits/payment being applied and that of the invoice should match.


The reports will display aggregate values in the base currency, by default. The value of transactions in all the configured currencies will be converted to the base currency value using their respective exchange rates, and will form a part of the reports' numbers.

You can also get the metrics in the currency you require by selecting the currency from the dropdown menu on the top right corner.

The option to change currencies will also be available for the following reports:

  • At a glance
  • Monthly Plan Revenue
  • Monthly Addon Revenue
  • ARPU
  • Renewal Summary