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 |