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.