Supported currencies
Find a supported currency and the integer amount to send to the API. Find a currency.
Currency minor units
Send monetary amounts as integers. For example, USD 10.99 becomes 1099, while JPY 1,000 stays 1000.
How minor units work
| Conversion | Display → API amount |
|---|---|
| ×1 · Zero-decimal currencies | JPY 1,000 → 1000 |
| ×100 · All other supported currencies | USD 10.99 → 1099 |
| ×1,000 · Three-decimal currencies | BHD 10.500 → 10500 |
Tokenz exception: IDR and TWD use ×1 in the Tokenz API, although ISO 4217 specifies two decimal places. Use Tokenz's conversion rule for API amounts.
Zero-decimal currencies
Send the amount unchanged for these currencies:
| Code | Currency |
|---|---|
CLP | Chilean Peso |
IDR | Indonesian Rupiah |
JPY | Japanese Yen |
KRW | South Korean Won |
TWD | New Taiwan Dollar |
UGX | Ugandan Shilling |
VND | Vietnamese Dong |
Three-decimal currencies
Multiply the displayed amount by 1,000 for these currencies:
| Code | Currency |
|---|---|
BHD | Bahraini Dinar |
KWD | Kuwaiti Dinar |
OMR | Omani Rial |
API format consistency
Requests and responses use the same integer format. Reuse response amounts in subsequent API calls without converting them.
API examples
This price charges USD 24.99:
{
"price": {
"currency": "USD",
"amount": 2499
}
}
Important notes
- Divide an API amount by the conversion factor before displaying it to a customer.
- Payment methods may have different minimum and maximum amounts for each currency.
Supported currencies list
Search by code, currency name, or symbol. The conversion and example show how to encode amounts for each supported currency.
Complete currency minor unit reference
* Tokenz treats IDR, TWD as zero-decimal currencies. This differs from the ISO 4217 convention, which specifies 2 decimals for these. JPY, KRW, and CLP are zero-decimal under both Tokenz and ISO 4217.
- AEDUAE DirhamFils
- Conversion×100
- Display amountد.إ10.00
- API amount
1000 - AUDAustralian DollarCents
- Conversion×100
- Display amount$10.00
- API amount
1000 - BDTBangladeshi TakaPaisa
- Conversion×100
- Display amount৳10.00
- API amount
1000 - BGNBulgarian LevStotinka
- Conversion×100
- Display amountлв10.00
- API amount
1000 - BHDBahraini DinarFils
- Conversion×1000
- Display amount.د.ب10.000
- API amount
10000 - BRLBrazilian RealCentavos
- Conversion×100
- Display amountR$10.00
- API amount
1000 - CADCanadian DollarCents
- Conversion×100
- Display amount$10.00
- API amount
1000 - CHFSwiss FrancRappen/Centimes
- Conversion×100
- Display amountFr.10.00
- API amount
1000 - CLPChilean Peso-
- Conversion×1
- Display amount$1000
- API amount
1000 - CNYChinese YuanFen
- Conversion×100
- Display amount¥10.00
- API amount
1000 - COPColombian PesoCentavos
- Conversion×100
- Display amount$10.00
- API amount
1000 - CZKCzech KorunaHaléř
- Conversion×100
- Display amountKč10.00
- API amount
1000 - DKKDanish KroneØre
- Conversion×100
- Display amountkr10.00
- API amount
1000 - EUREuroCents
- Conversion×100
- Display amount€10.00
- API amount
1000 - GBPBritish PoundPence
- Conversion×100
- Display amount£10.00
- API amount
1000 - GHSGhanaian CediPesewas
- Conversion×100
- Display amountGH₵10.00
- API amount
1000 - HKDHong Kong DollarCents
- Conversion×100
- Display amount$10.00
- API amount
1000 - HUFHungarian ForintFillér
- Conversion×100
- Display amountFt10.00
- API amount
1000 - IDR*Indonesian Rupiah-
- Conversion×1
- Display amountRp1000
- API amount
1000 - JPYJapanese Yen-
- Conversion×1
- Display amount¥1000
- API amount
1000 - KESKenyan ShillingCents
- Conversion×100
- Display amountKSh10.00
- API amount
1000 - KRWSouth Korean Won-
- Conversion×1
- Display amount₩1000
- API amount
1000 - KWDKuwaiti DinarFils
- Conversion×1000
- Display amountد.ك10.000
- API amount
10000 - LKRSri Lankan RupeeCents
- Conversion×100
- Display amount௹10.00
- API amount
1000 - MADMoroccan DirhamSantim
- Conversion×100
- Display amountDH10.00
- API amount
1000 - MXNMexican PesoCentavos
- Conversion×100
- Display amountMex$10.00
- API amount
1000 - MYRMalaysian RinggitSen
- Conversion×100
- Display amountRM10.00
- API amount
1000 - NOKNorwegian KroneØre
- Conversion×100
- Display amountkr10.00
- API amount
1000 - NZDNew Zealand DollarCents
- Conversion×100
- Display amount$10.00
- API amount
1000 - OMROmani RialBaisa
- Conversion×1000
- Display amount﷼10.000
- API amount
10000 - PENPeruvian SolCéntimos
- Conversion×100
- Display amountS/10.00
- API amount
1000 - PHPPhilippine PesoCentavos
- Conversion×100
- Display amount₱10.00
- API amount
1000 - PKRPakistani RupeePaisa
- Conversion×100
- Display amountRs10.00
- API amount
1000 - PLNPolish ZłotyGroszy
- Conversion×100
- Display amountzł10.00
- API amount
1000 - QARQatari RiyalDirham
- Conversion×100
- Display amountر.ق10.00
- API amount
1000 - RONRomanian LeuBani
- Conversion×100
- Display amountlei10.00
- API amount
1000 - SARSaudi RiyalHalala
- Conversion×100
- Display amount﷼10.00
- API amount
1000 - SEKSwedish KronaÖre
- Conversion×100
- Display amountkr10.00
- API amount
1000 - SGDSingapore DollarCents
- Conversion×100
- Display amount$10.00
- API amount
1000 - THBThai BahtSatang
- Conversion×100
- Display amount฿10.00
- API amount
1000 - TWD*New Taiwan Dollar-
- Conversion×1
- Display amountNT$1000
- API amount
1000 - TZSTanzanian ShillingCents
- Conversion×100
- Display amountTSh10.00
- API amount
1000 - UGXUgandan Shilling-
- Conversion×1
- Display amountUSh1000
- API amount
1000 - USDUS DollarCents
- Conversion×100
- Display amount$10.00
- API amount
1000 - VNDVietnamese Dong-
- Conversion×1
- Display amount₫1000
- API amount
1000