What is a currency minor unit?

A minor unit is the smallest denomination of a currency — cents for the US dollar, pence for the pound, fils for the dinar. ISO 4217 defines an exponent for each currency that says how many decimal digits the minor unit has, which is how you convert between the two.

Why do payment APIs want amounts in cents?

APIs such as Stripe, PayPal, and Adyen represent money as integers in the smallest unit to avoid floating-point rounding errors. So $19.99 is sent as 1999. Using integers means a payment of $0.10 is always exactly 10, never 9.9999999.

Why is the multiplier not always 100?

Most currencies have an exponent of 2, so you multiply by 100. But the Japanese yen has exponent 0 (no subunit, so the multiplier is 1) and Gulf dinars like BHD and KWD have exponent 3, so you multiply by 1000. Hard-coding ×100 silently overcharges or undercharges those currencies.

How does the tool avoid floating-point errors?

When converting major to minor it multiplies by ten to the exponent and rounds to the nearest integer. This corrects artifacts such as 19.99 × 100 evaluating to 1998.9999999, which would otherwise truncate to 1998 instead of the correct 1999.

What happens with zero-decimal currencies like JPY?

Zero-decimal currencies have exponent 0, meaning the major and minor amounts are identical — ¥2000 is sent as 2000, not 200000. The converter detects this and tells you the units are the same, which is a common source of 100x overcharge bugs.

Currency Minor Unit Converter

Convert money between major and minor units correctly

The Currency Minor Unit Converter turns a human-readable amount like $19.99 into the integer 1999 that payment APIs expect, and back again. It uses the official ISO 4217 minor-unit exponent for each currency, so it stays correct for zero-decimal currencies like the Japanese yen and three-decimal currencies like the Bahraini dinar.

How it works

ISO 4217 assigns each currency an exponent — the number of decimal digits in its minor unit. The conversion is a simple power of ten:

minor = round(major × 10^exponent)
major = minor ÷ 10^exponent

USD has exponent 2: 19.99 × 100 = 1999 cents.
JPY has exponent 0: 2000 × 1 = 2000 — major and minor are the same.
BHD has exponent 3: 1.999 × 1000 = 1999 fils.

When converting major to minor, the tool rounds to the nearest integer. This matters because 19.99 * 100 in floating-point arithmetic can evaluate to 1998.9999999999998; naive truncation would give 1998 instead of the correct 1999.

Example

Sending a charge of 1.5 BHD to a payment processor requires 1500, not 150. Selecting BHD (exponent 3) and converting major to minor gives exactly that. Conversely, refunding 1500 minor BHD divides by 1000 to show 1.500 BHD.

Notes

Always derive the multiplier from the ISO 4217 exponent rather than hard-coding ×100. A fixed multiplier silently fails for the dozen-plus zero-decimal and three-decimal currencies, causing 100x overcharges or undercharges that are easy to miss in testing.