Currency codes and digits

The ISO 4217 standard defines codes and decimals for every currency.

Numeral uses integers in all payment and transaction amount attributes in API requests and responses as well as events to webhooks. Customers should then translates amounts accordingly.

Most currencies have two decimals, but some have zero and others have three. This table lists the currencies supported by Numeral, their ISO code, and their number of decimals.

CurrencyCodeDecimals
AfghaniAFN2
EuroEUR2
LekALL2
Algerian DinarDZD2
US DollarUSD2
EuroEUR2
KwanzaAOA2
East Caribbean DollarXCD2
No universal currency
East Caribbean DollarXCD2
Argentine PesoARS2
Armenian DramAMD2
Aruban FlorinAWG2
Australian DollarAUD2
EuroEUR2
Azerbaijan ManatAZN2
Bahamian DollarBSD2
Bahraini DinarBHD3
TakaBDT2
Barbados DollarBBD2
Belarusian RubleBYN2
EuroEUR2
Belize DollarBZD2
CFA Franc BCEAOXOF0
Bermudian DollarBMD2
Indian RupeeINR2
NgultrumBTN2
BolivianoBOB2
MvdolBOV2
US DollarUSD2
Convertible MarkBAM2
PulaBWP2
Norwegian KroneNOK2
Brazilian RealBRL2
US DollarUSD2
Brunei DollarBND2
Bulgarian LevBGN2
CFA Franc BCEAOXOF0
Burundi FrancBIF0
Cabo Verde EscudoCVE2
RielKHR2
CFA Franc BEACXAF0
Canadian DollarCAD2
Cayman Islands DollarKYD2
CFA Franc BEACXAF0
CFA Franc BEACXAF0
Chilean PesoCLP0
Unidad de FomentoCLF4
Yuan RenminbiCNY2
Australian DollarAUD2
Australian DollarAUD2
Colombian PesoCOP2
Unidad de Valor RealCOU2
Comorian FrancKMF0
Congolese FrancCDF2
CFA Franc BEACXAF0
New Zealand DollarNZD2
Costa Rican ColonCRC2
CFA Franc BCEAOXOF0
EuroEUR2
Cuban PesoCUP2
Peso ConvertibleCUC2
Netherlands Antillean GuilderANG2
EuroEUR2
Czech KorunaCZK2
Danish KroneDKK2
Djibouti FrancDJF0
East Caribbean DollarXCD2
Dominican PesoDOP2
US DollarUSD2
Egyptian PoundEGP2
El Salvador ColonSVC2
US DollarUSD2
CFA Franc BEACXAF0
NakfaERN2
EuroEUR2
LilangeniSZL2
Ethiopian BirrETB2
EuroEUR2
Falkland Islands PoundFKP2
Danish KroneDKK2
Fiji DollarFJD2
EuroEUR2
EuroEUR2
EuroEUR2
CFP FrancXPF0
EuroEUR2
CFA Franc BEACXAF0
DalasiGMD2
LariGEL2
EuroEUR2
Ghana CediGHS2
Gibraltar PoundGIP2
EuroEUR2
Danish KroneDKK2
East Caribbean DollarXCD2
EuroEUR2
US DollarUSD2
QuetzalGTQ2
Pound SterlingGBP2
Guinean FrancGNF0
CFA Franc BCEAOXOF0
Guyana DollarGYD2
GourdeHTG2
US DollarUSD2
Australian DollarAUD2
EuroEUR2
LempiraHNL2
Hong Kong DollarHKD2
ForintHUF2
Iceland KronaISK0
Indian RupeeINR2
RupiahIDR2
SDR (Special Drawing Right)XDRN.A.
Iranian RialIRR2
Iraqi DinarIQD3
EuroEUR2
Pound SterlingGBP2
New Israeli SheqelILS2
EuroEUR2
Jamaican DollarJMD2
YenJPY0
Pound SterlingGBP2
Jordanian DinarJOD3
TengeKZT2
Kenyan ShillingKES2
Australian DollarAUD2
North Korean WonKPW2
WonKRW0
Kuwaiti DinarKWD3
SomKGS2
Lao KipLAK2
EuroEUR2
Lebanese PoundLBP2
LotiLSL2
RandZAR2
Liberian DollarLRD2
Libyan DinarLYD3
Swiss FrancCHF2
EuroEUR2
EuroEUR2
PatacaMOP2
DenarMKD2
Malagasy AriaryMGA2
Malawi KwachaMWK2
Malaysian RinggitMYR2
RufiyaaMVR2
CFA Franc BCEAOXOF0
EuroEUR2
US DollarUSD2
EuroEUR2
OuguiyaMRU2
Mauritius RupeeMUR2
EuroEUR2
ADB Unit of AccountXUAN.A.
Mexican PesoMXN2
Mexican Unidad de Inversion (UDI)MXV2
US DollarUSD2
Moldovan LeuMDL2
EuroEUR2
TugrikMNT2
EuroEUR2
East Caribbean DollarXCD2
Moroccan DirhamMAD2
Mozambique MeticalMZN2
KyatMMK2
Namibia DollarNAD2
RandZAR2
Australian DollarAUD2
Nepalese RupeeNPR2
EuroEUR2
CFP FrancXPF0
New Zealand DollarNZD2
Cordoba OroNIO2
CFA Franc BCEAOXOF0
NairaNGN2
New Zealand DollarNZD2
Australian DollarAUD2
US DollarUSD2
Norwegian KroneNOK2
Rial OmaniOMR3
Pakistan RupeePKR2
US DollarUSD2
No universal currency
BalboaPAB2
US DollarUSD2
KinaPGK2
GuaraniPYG0
SolPEN2
Philippine PesoPHP2
New Zealand DollarNZD2
ZlotyPLN2
EuroEUR2
US DollarUSD2
Qatari RialQAR2
EuroEUR2
Romanian LeuRON2
Russian RubleRUB2
Rwanda FrancRWF0
EuroEUR2
Saint Helena PoundSHP2
East Caribbean DollarXCD2
East Caribbean DollarXCD2
EuroEUR2
EuroEUR2
East Caribbean DollarXCD2
TalaWST2
EuroEUR2
DobraSTN2
Saudi RiyalSAR2
CFA Franc BCEAOXOF0
Serbian DinarRSD2
Seychelles RupeeSCR2
LeoneSLE2
Singapore DollarSGD2
Netherlands Antillean GuilderANG2
SucreXSUN.A.
EuroEUR2
EuroEUR2
Solomon Islands DollarSBD2
Somali ShillingSOS2
RandZAR2
No universal currency
South Sudanese PoundSSP2
EuroEUR2
Sri Lanka RupeeLKR2
Sudanese PoundSDG2
Surinam DollarSRD2
Norwegian KroneNOK2
Swedish KronaSEK2
Swiss FrancCHF2
WIR EuroCHE2
WIR FrancCHW2
Syrian PoundSYP2
New Taiwan DollarTWD2
SomoniTJS2
Tanzanian ShillingTZS2
BahtTHB2
US DollarUSD2
CFA Franc BCEAOXOF0
New Zealand DollarNZD2
Pa’angaTOP2
Trinidad and Tobago DollarTTD2
Tunisian DinarTND3
Turkish LiraTRY2
Turkmenistan New ManatTMT2
US DollarUSD2
Australian DollarAUD2
Uganda ShillingUGX0
HryvniaUAH2
UAE DirhamAED2
Pound SterlingGBP2
US DollarUSD2
US DollarUSD2
US Dollar (Next day)USN2
Peso UruguayoUYU2
Uruguay Peso en Unidades Indexadas (UI)UYI0
Unidad PrevisionalUYW4
Uzbekistan SumUZS2
VatuVUV0
Bolívar SoberanoVES2
Bolívar SoberanoVED2
DongVND0
US DollarUSD2
US DollarUSD2
CFP FrancXPF0
Moroccan DirhamMAD2
Yemeni RialYER2
Zambian KwachaZMW2
Zimbabwe DollarZWL2
Zimbabwe GoldZWG2