Currency support

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.

Note: Once Multicurrency support is enabled, certain API methods will require currency_code parameter. 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