# Amounts and currencies

All amounts are expressed as integers in the currency minor unit (also known as the "smallest currency unit").

Numeral uses standard ISO4217 currency codes to designate currencies. Most currencies, such as the euro (EUR), the US dollar (USD), or the pound sterling (GBP), have two decimals, which means that the last two figures of an amount correspond to its decimals. Some currencies, such as the Japanese yen (JPY), have no decimals.

Here are a few examples:

- The euro has 2 decimals. €10.00 is thus expressed as
`1000`

- The Japanese yen has no decimals. ¥10 is thus expressed as
`10`

- The Tunisian dinar has 3 decimals. TND 10.000 is thus expressed as
`10000`

# Payment orders

Numeral currently only supports SEPA payments. As a result, EUR is the only supported currency for payment orders. As euro is a two-decimal currency, to send a payment of €12.34, the `amount`

would be `1234`

.

# Expected payments

Expected payments can be expressed with any ISO 4217 currency code. Please make sure that the amount is also expressed in the currency minor unit.

# Balances and transactions

Balances and transactions can be retrieved by Numeral with any ISO 4217 currency code. As the amount is always expressed in the currency minor unit, a EUR transaction with an `amount`

of `1234`

must be understood as a €12.34 transaction.

Updated over 1 year ago