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
valuefield 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
| Exponent | Description | Example Currencies |
|---|---|---|
0 | No decimals | BIF, BYR, CLF, 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 1 day ago