ISO 4217 Currency Codes and Amount Exponents

DE49 carries the numeric code, not the letter code — and the exponent decides how the amount reads. There's a converter below.

Two things people get wrong

First, DE49 holds the numeric code. The message says 392, not JPY; 840, not USD. Mixing the two up when mapping to an internal system produces wrong-currency bugs that typically surface only at reconciliation.

Second, amounts are integers in the currency's minor unit. DE4 has no decimal point. What 000000012345 means depends entirely on the currency: 123.45 in USD, 12,345 in JPY, 12.345 in KWD.

What to do instead

Keep a currency → exponent table, drive every conversion off it, and never let a literal 100 appear next to an amount. Use the converter above to check your implementation against a known value.

It is not only DE4

DE5 (settlement amount), DE6 (cardholder billing amount) and the EMV tag 9F02 follow the same convention. On a cross-border transaction those three can each be in a different currency — check DE49, DE50 and DE51 respectively rather than assuming they match.

The exponent is the part that breaks things

Amount fields in ISO 8583 carry no decimal point. The number is an integer of minor units, and how many minor units make one unit comes from the currency, not from the message. Assume two decimal places everywhere and you will be wrong in both directions.

Japanese yen has an exponent of 0: 000000001000 in a yen transaction is 1,000 yen, not 10.00. Kuwaiti dinar, Bahraini dinar and Jordanian dinar have an exponent of 3: the same digits are 1.000 dinar. A single hard-coded division by 100 turns a thousand-yen coffee into a ten-yen one and a one-dinar fare into a thousand-dinar one, and neither error looks like an error in a log.

Two further traps that the table above cannot show you. The numeric code and the alphabetic code are assigned independently, so you cannot derive one from the other or sort by one and expect the other to follow. And ISO 4217 contains codes no card network supports — including funds codes and metals — so a value being a valid ISO currency code is not the same as it being routable. The arithmetic, with worked examples, is in amounts and minor units.

Read next

• ISO 4217 currency codes: the complete numeric list
• How One Card Holds Ten Currencies (ucardly.com)
• Why ISO 8583 amounts have no decimal point
• ISO 8583 field quick reference
• DE39 response code lookup