Displaying Currencies

Rounding

We always recommend that the merchant does any rounding on the merchant's side. That way, the merchant always has control of the rounding rules.

Currencies that don't have (or don't support) minor units

BIF, BYR, CLF, CLP, CVE, DJF, GNF, ISK, JPY, KMF, KRW, PYG, RWF, UGX, UYI, VND, VUV, XAF, XOF, XPF

At Reach, we don't process any decimals for currencies like JPY or KRW that don't have minor units. Additionally, we always round up. So, if you send an amount of 100.4 JPY, we would round to 101. Even for an amount of 100.01, we would round up to 101.

Currencies that technically have 2 minor units, but 0 in practice

IDR, MGA, MRO

Currencies that support 3 minor units, but Reach only accepts 2

BHD, IQD, JOD, KWD, LYD, OMR, TND

Currency that supports 4 minor units, but Reach only accepts 2

COU

Refunds

Reach does not round on /refund requests. However, the merchant should be able to see how much was actually charged in the response to /checkout and in /query. That amount is rounded based on the rules described here. Based on that amount actually charged, the merchant can find out the correct amount to refund.

Character Width

Changing currency units can mean drastic differences in the width of the number field. An item that costs only USD 1 may convert to JPY 1000. As you localize your checkout, it's important to remember to allow for this resizing of any data field that contains amounts by currency.

Formatting Euro

The creation of the European Union made it much easier to handle currencies across the region - no more Marks, Francs, or other country-specific currencies. However, one thing to remember is that each country had its own way of formatting their currency, and even though individual currencies have unified under the Euro (EUR or €), there is no set method for formatting the Euro. In this way, each country formats the Euro in its own localized way. For example, €1,000.00 and €1.000,00 are both acceptable formats in different regions.

For more information on considerations when styling international currencies and monetary values, see here (Wiki style) and here (European Union style).

Note: Currency display best practices are subject to change without prior notice. Inclusion of a currency in the above list does not indicate guaranteed support for this currency by Reach.