When 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 CodeCurrency NameDecimal Units
USDUS Dollar2
ZARSouth African Rand2

​
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

CurrencyDecimal PlacesAmount (Major Units)Amount (Minor Units)
USD (US Dollar)210.00 USD1000 cents
ZAR (South African Rand)210.00 ZAR1000 cents
GBP (British Pound)210.00 GBP1000 pence
JPY (Japanese Yen)010 JPY10 yen
BHD (Bahraini Dinar)310.000 BHD10000 fils
This format ensures consistency when processing payments across different currencies.