> ## Documentation Index
> Fetch the complete documentation index at: https://docs.momentco.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Monetary Amounts

> Learn how the API works with monetary amounts

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](https://www.iso.org/iso-4217-currency-codes.html) standard. The number of decimals determines how to express the currency amounts in minor units.

### Supported currencies

| **Currency Code** | **Symbol** | **Currency Name**  | **Decimal Units** |
| ----------------- | ---------- | ------------------ | ----------------- |
| EUR               | €          | Euro               | 2                 |
| GBP               | £          | British Pound      | 2                 |
| KES               | KSh        | Kenyan Shilling    | 2                 |
| NGN               | ₦          | Nigerian Naira     | 2                 |
| TZS               | TSh        | Tanzanian Shilling | 2                 |
| UGX               | USh        | Ugandan Shilling   | 0                 |
| USD               | \$         | US Dollar          | 2                 |
| ZAR               | R          | 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

<Note>
  The table below illustrates how minor units work across different decimal place conventions. Currencies not in the [supported currencies](#supported-currencies) list are included for illustration only.
</Note>

| **Currency**                 | **Decimal Places** | **Amount (Major Units)** | **Amount (Minor Units)** |
| ---------------------------- | ------------------ | ------------------------ | ------------------------ |
| **BHD** (Bahraini Dinar)     | 3                  | 10.000 BHD               | 10000 fils               |
| **EUR** (Euro)               | 2                  | 10.00 EUR                | 1000 cents               |
| **GBP** (British Pound)      | 2                  | 10.00 GBP                | 1000 pence               |
| **JPY** (Japanese Yen)       | 0                  | 10 JPY                   | 10 yen                   |
| **KES** (Kenyan Shilling)    | 2                  | 10.00 KES                | 1000 cents               |
| **NGN** (Nigerian Naira)     | 2                  | 10.00 NGN                | 1000 kobo                |
| **TZS** (Tanzanian Shilling) | 2                  | 10.00 TZS                | 1000 cents               |
| **UGX** (Ugandan Shilling)   | 0                  | 10 UGX                   | 10 shillings             |
| **USD** (US Dollar)          | 2                  | 10.00 USD                | 1000 cents               |
| **ZAR** (South African Rand) | 2                  | 10.00 ZAR                | 1000 cents               |

This format ensures consistency when processing payments across different currencies.