Skip to main content

​
Currency Amount Formatting

Amount values are always provided in the currency’s smallest unit. The format depends on the currency’s decimal structure: • For most currencies (exponent = 2): – Currencies: USD, CAD, EUR, GBP, etc. – Enter amounts in cents/pence (smallest fractional unit) – Example: “1000” → $10.00 USD, €10.00 EUR, £10.00 GBP • Exception – no fractional unit (exponent = 0): – Currencies: CLP, JPY, KRW, VND – Enter amounts as whole units (not divided by 100) – Example: “1000” → ¥1000 JPY, ₩1000 KRW (not divided) This ensures accurate processing and representation across all currencies, especially with respect to rounding. When creating a calculation for a product that costs $10.00 USD, you’d report that value as 1000 cents in the amount field. For a product that costs ¥1000 JPY, you’d report that value as 1000 in the amount field.
In the same way, tax and accounting values returned are also in the currency’s smallest unit (e.g., if USD then this is returned in cents where 2000 = $20.00). The below response is for a calculation on a $2.00 USD item with a 7% tax rate. This leads to 14 cents in tax.

​
Supported Currencies by API Version

The supported currencies depend on which API version you’re using:

​
2025-05-12 - 32 Currencies

The API version 2025-05-12 supports all currencies from the previous version plus 22 additional currencies for a total of 32:

​
Original 10 Currencies (from 2024-09-01)

​
Additional 22 Currencies (new in 2025-05-12)

​
How to Specify Currency

When creating calculations, specify the currency in the customer_currency_code field:

​
Exchange Rates

Once per day, we will reconcile all transactions that were created in the last 24 hours, and record the exchange rate(s) for that day. This allows us to present a single report in your functional currency on your dashboard, even if you are collecting and filing tax across multiple countries.