Monetary Values
Some endpoints in our API require or return monetary values. For example, when setting a card limit, you must provide both the value
and the currency
.
ISO 4217 Compliance
Our API complies with the ISO 4217 standard for currency codes. This ensures:
- Compatibility with a wide range of international currencies
- Accurate precision handling for each currency’s decimal system
- Flexibility in supporting any currency allowed by your payment provider or acquiring contract
Minor Units
Monetary value
fields are always expressed in minor units of the respective currency:
- For EUR or USD, provide cent values.
- For JPY, provide full yen values (no decimal places).
- For KWD, provide values in thousandths.
For example, to set a card limit of €200.00, you would pass 20000
as the value
and EUR
as the currency
.
The
value
field must always be an integer — no decimal points allowed.
Depending on the transaction type, monetary values may be positive or negative.
Minor Units by Currency Exponent
In the table below you can find some example currencies. To get the full list of currencies and their respective minor units, please visit the list at ISO.org.
Exponent | Description | Example Currencies |
---|---|---|
0 | No decimals | BIF, BYR, CLP, DJF, GNF, ISK, JPY, KMF, KRW, PYG, RWF, UGX, UYI, VND, VUV, XAF, XOF, XPF |
2 | Two decimals (most common) | EUR, USD, CHF, GBP |
3 | Three decimals | BHD, IQD, JOD, KWD, LYD, OMR, TND |
Examples
Currency | Human-Readable Amount | Value to Submit | Notes |
---|---|---|---|
JPY | ¥1,000 | 1000 | JPY has no decimal places |
USD | $50.50 | 5050 | USD has two decimal places (cents) |
KWD | KD 0.250 | 250 | KWD has three decimal places (fils) |
Please ensure you handle currency values accurately based on their minor unit rules. If you’re unsure whether a specific currency is supported, check your acquiring contract or contact us.
Updated 16 days ago