Loading search…

Loading search…

Skip to content
PaymentsSupported currencies

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

Scroll horizontally if needed
ConversionDisplay → API amount
×1 · Zero-decimal currenciesJPY 1,000 → 1000
×100 · All other supported currenciesUSD 10.99 → 1099
×1,000 · Three-decimal currenciesBHD 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:

Scroll horizontally if needed
CodeCurrency
CLPChilean Peso
IDRIndonesian Rupiah
JPYJapanese Yen
KRWSouth Korean Won
TWDNew Taiwan Dollar
UGXUgandan Shilling
VNDVietnamese Dong

Three-decimal currencies

Multiply the displayed amount by 1,000 for these currencies:

Scroll horizontally if needed
CodeCurrency
BHDBahraini Dinar
KWDKuwaiti Dinar
OMROmani 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:

json
{
  "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.

45 of 45 currencies
AEDUAE DirhamFils
Conversion×100
Display amountد.إ10.00
API amount1000
AUDAustralian DollarCents
Conversion×100
Display amount$10.00
API amount1000
BDTBangladeshi TakaPaisa
Conversion×100
Display amount৳10.00
API amount1000
BGNBulgarian LevStotinka
Conversion×100
Display amountлв10.00
API amount1000
BHDBahraini DinarFils
Conversion×1000
Display amount.د.ب10.000
API amount10000
BRLBrazilian RealCentavos
Conversion×100
Display amountR$10.00
API amount1000
CADCanadian DollarCents
Conversion×100
Display amount$10.00
API amount1000
CHFSwiss FrancRappen/Centimes
Conversion×100
Display amountFr.10.00
API amount1000
CLPChilean Peso-
Conversion×1
Display amount$1000
API amount1000
CNYChinese YuanFen
Conversion×100
Display amount¥10.00
API amount1000
COPColombian PesoCentavos
Conversion×100
Display amount$10.00
API amount1000
CZKCzech KorunaHaléř
Conversion×100
Display amountKč10.00
API amount1000
DKKDanish KroneØre
Conversion×100
Display amountkr10.00
API amount1000
EUREuroCents
Conversion×100
Display amount€10.00
API amount1000
GBPBritish PoundPence
Conversion×100
Display amount£10.00
API amount1000
GHSGhanaian CediPesewas
Conversion×100
Display amountGH₵10.00
API amount1000
HKDHong Kong DollarCents
Conversion×100
Display amount$10.00
API amount1000
HUFHungarian ForintFillér
Conversion×100
Display amountFt10.00
API amount1000
IDR*Indonesian Rupiah-
Conversion×1
Display amountRp1000
API amount1000
JPYJapanese Yen-
Conversion×1
Display amount¥1000
API amount1000
KESKenyan ShillingCents
Conversion×100
Display amountKSh10.00
API amount1000
KRWSouth Korean Won-
Conversion×1
Display amount₩1000
API amount1000
KWDKuwaiti DinarFils
Conversion×1000
Display amountد.ك10.000
API amount10000
LKRSri Lankan RupeeCents
Conversion×100
Display amount௹10.00
API amount1000
MADMoroccan DirhamSantim
Conversion×100
Display amountDH10.00
API amount1000
MXNMexican PesoCentavos
Conversion×100
Display amountMex$10.00
API amount1000
MYRMalaysian RinggitSen
Conversion×100
Display amountRM10.00
API amount1000
NOKNorwegian KroneØre
Conversion×100
Display amountkr10.00
API amount1000
NZDNew Zealand DollarCents
Conversion×100
Display amount$10.00
API amount1000
OMROmani RialBaisa
Conversion×1000
Display amount﷼10.000
API amount10000
PENPeruvian SolCéntimos
Conversion×100
Display amountS/10.00
API amount1000
PHPPhilippine PesoCentavos
Conversion×100
Display amount₱10.00
API amount1000
PKRPakistani RupeePaisa
Conversion×100
Display amountRs10.00
API amount1000
PLNPolish ZłotyGroszy
Conversion×100
Display amountzł10.00
API amount1000
QARQatari RiyalDirham
Conversion×100
Display amountر.ق10.00
API amount1000
RONRomanian LeuBani
Conversion×100
Display amountlei10.00
API amount1000
SARSaudi RiyalHalala
Conversion×100
Display amount﷼10.00
API amount1000
SEKSwedish KronaÖre
Conversion×100
Display amountkr10.00
API amount1000
SGDSingapore DollarCents
Conversion×100
Display amount$10.00
API amount1000
THBThai BahtSatang
Conversion×100
Display amount฿10.00
API amount1000
TWD*New Taiwan Dollar-
Conversion×1
Display amountNT$1000
API amount1000
TZSTanzanian ShillingCents
Conversion×100
Display amountTSh10.00
API amount1000
UGXUgandan Shilling-
Conversion×1
Display amountUSh1000
API amount1000
USDUS DollarCents
Conversion×100
Display amount$10.00
API amount1000
VNDVietnamese Dong-
Conversion×1
Display amount₫1000
API amount1000