Skip to main contentWhen making API requests, monetary amounts must include a currency code and a value. The value must be specified in minor units, based on the currency’s decimal places. This page lists supported currency codes and explains minor units.
Currency Code Explained
Currencies are specified using three-letter currency codes that follow the ISO 4217 Alpha-3 standard. The number of decimals determines how to express the currency amounts in minor units.
Supported currencies
| Currency Code | Currency Name | Decimal Units |
|---|
| USD | US Dollar | 2 |
| ZAR | South African Rand | 2 |
Minor Units Explained
Monetary amounts must be provided in minor units — the smallest unit of a currency, such as cents or pennies. The number of minor units depends on the currency’s decimal places. For example, ZAR 10.95 is represented as 1095 (in cents).
Understanding Minor Units
- Most currencies use two decimal places (e.g., ZAR, USD, GBP), meaning you would multiply the currency amount by 100 to get the value in minor units.
- Some currencies have no decimal places (e.g., JPY).
- A few currencies use three decimal places (e.g., BHD).
Examples
| Currency | Decimal Places | Amount (Major Units) | Amount (Minor Units) |
|---|
| USD (US Dollar) | 2 | 10.00 USD | 1000 cents |
| ZAR (South African Rand) | 2 | 10.00 ZAR | 1000 cents |
| GBP (British Pound) | 2 | 10.00 GBP | 1000 pence |
| JPY (Japanese Yen) | 0 | 10 JPY | 10 yen |
| BHD (Bahraini Dinar) | 3 | 10.000 BHD | 10000 fils |
