Chargebee supports billing in 100+ currencies. On this page you can find information about how currency and quantity units are expressed in the API and certain pointers to keep in mind when using multiple currencies.

Handling currency units

While specifying amount in any currency, you need to provide the amount in the smallest unit of that currency. For example, to specify an amount of $1.50, you would set amount=150 (i.e. 150 cents).

For zero decimal currencies (currencies that do not have decimal units), however, you need to provide the amount in the regular denomination. For example, to specify an amount of ¥15, you would set amount=15 (i.e. 15 yens).

Chargebee currently supports below zero-decimal currencies:

• KRW - South Korean Won
• JPY - Japanese Yen
• XAF - Central African CFA Franc
• XOF - West African CFA Franc

Multi-currency support

With our Multicurrency support, you will be able to process transactions in additional currencies apart from your site's Base currency.

Once Multicurrency support is enabled, the API methods listed below will throw an error as currency_code is required for these methods to work and the same is not supported in the V1 version. So upgrade to our latest version (V2) to be able to pass currency_code input parameter to these methods in Multicurrency mode.

The list of API methods affected if Multicurrency support is enabled:

• Customer related methods
• Add account credits to a customer
• Deduct account credits from a customer
• Set account credits for a customer
• Invoice related methods
• Create an invoice
• Create invoice for charge
• Product Configuration related methods
• Create a plan
• Update a plan
• Create an addon
• Update an addon
• Create a coupon