支援的貨幣

了解 Tokenz Checkout 支援的貨幣以及如何正確格式化每種貨幣的金額值。

支援的貨幣清單

Checkout 支援橫跨亞太地區、歐洲、北美、中東、拉丁美洲、非洲和南亞的貨幣。以下是支援的貨幣完整清單：

尋找貨幣

地區

45 / 45 種貨幣

亞太地區貨幣

AUD澳元$
CNY人民幣¥
HKD港幣$
IDR^*印尼盾Rp
JPY日圓¥
KRW韓元₩
MYR令吉RM
PHP披索₱
SGD新加坡幣$
THB泰銖฿
TWD^*新臺幣NT$

歐洲貨幣

BGN保加利亞列弗лв
CHF瑞士法郎Fr.
CZK捷克克朗Kč
DKK丹麥克朗kr
EUR歐元€
GBP英鎊£
HUF福林Ft
NOK挪威克朗kr
PLN茲羅提zł
RON新列伊lei
SEK瑞典克朗kr

北美貨幣

CAD加元$
USD美元$

中東貨幣

AED阿聯酋迪拉姆د.إ
BHD巴林迪納.د.ب
KWD科威特丁那د.ك
OMR阿曼里亞爾﷼
QAR卡達里亞爾ر.ق
SAR沙烏地里亞爾﷼

拉丁美洲貨幣

BRL巴西黑奧R$
CLP智利披索$
COP哥倫比亞披索$
MXN墨西哥披索Mex$
PEN新索爾S/

非洲貨幣

GHS塞地GH₵
KES肯亞先令KSh
MAD摩洛哥迪爾汗DH

南亞貨幣

BDT孟加拉塔卡৳
LKR斯里蘭卡盧比௹
PKR巴基斯坦盧比Rs

其他貨幣

NZDNew Zealand Dollar$
TZSTanzanian ShillingTSh
UGXUgandan ShillingUSh
VNDVietnamese Dong₫

* Tokenz 將 IDR, TWD 視為零小數位貨幣。這與將其視為兩位小數的 ISO 4217 規約不同。JPY、KRW 和 CLP 在 Tokenz 和 ISO 4217 中均為零小數位貨幣。

貨幣最小單位

在 Tokenz API 中指定金額時，理解大多數貨幣需要以其最小單位（如分、派塞等）而不是主單位來指定金額這一點至關重要。這可以防止定價錯誤並確保準確的支付處理。

最小單位的運作原理

世界上大多數貨幣使用十進位系統，其中主單位被分為 100 個最小單位：

1 USD = 100 分
1 EUR = 100 分
1 GBP = 100 便士

在 API 中使用這些貨幣時，您必須將金額乘以 100。例如，要收取 $10.99，您應發送 1099（10.99 × 100）。

零小數位貨幣

部分貨幣不使用小數位，已經以其最小單位表示。這些被稱為零小數位貨幣。對於這些貨幣，您按原樣指定金額，無需乘法運算：

CLP - 智利披索
IDR - 印尼盾
JPY - 日圓
KRW - 韓圜
TWD - 新台幣
UGX - 烏干達先令
VND - 越南盾

說明： IDR 和 TWD 在 Tokenz API 中為零小數位貨幣，但 ISO 4217 將其規定為兩位小數。下方參考表中以星號（*）標記。

三位小數貨幣

部分貨幣使用三位小數，而不是標準的兩位小數。這些貨幣需要乘以 1000：

BHD - 巴林第納爾
KWD - 科威特第納爾
OMR - 阿曼里亞爾

例如，要收取 10.500 BHD，您應發送 10500（10.500 × 1000）。

所有其他支援的貨幣都使用最小單位，需要乘以 100。

貨幣最小單位完整參考

×1零位小數 · 金額不變

×100兩位小數 · 乘以100

×1000三位小數 · 乘以1,000

* Tokenz 將 IDR, TWD 視為零小數位貨幣。這與將其視為兩位小數的 ISO 4217 規約不同。JPY、KRW 和 CLP 在 Tokenz 和 ISO 4217 中均為零小數位貨幣。

尋找貨幣

45 / 45 種貨幣

AED阿聯酋迪拉姆費爾: 轉換×100; 顯示金額د.إ10.00; API金額1000
AUD澳元分: 轉換×100; 顯示金額$10.00; API金額1000
BDT孟加拉塔卡派沙: 轉換×100; 顯示金額৳10.00; API金額1000
BGN保加利亞列弗斯托丁基: 轉換×100; 顯示金額лв10.00; API金額1000
BHD巴林迪納費爾: 轉換×1000; 顯示金額.د.ب10.000; API金額10000
BRL巴西黑奧分: 轉換×100; 顯示金額R$10.00; API金額1000
CAD加元分: 轉換×100; 顯示金額$10.00; API金額1000
CHF瑞士法郎生丁/分: 轉換×100; 顯示金額Fr.10.00; API金額1000
CLP智利披索-: 轉換×1; 顯示金額$1000; API金額1000
CNY人民幣分: 轉換×100; 顯示金額¥10.00; API金額1000
COP哥倫比亞披索分: 轉換×100; 顯示金額$10.00; API金額1000
CZK捷克克朗赫勒: 轉換×100; 顯示金額Kč10.00; API金額1000
DKK丹麥克朗歐爾: 轉換×100; 顯示金額kr10.00; API金額1000
EUR歐元分: 轉換×100; 顯示金額€10.00; API金額1000
GBP英鎊便士: 轉換×100; 顯示金額£10.00; API金額1000
GHS塞地比塞瓦: 轉換×100; 顯示金額GH₵10.00; API金額1000
HKD港幣分: 轉換×100; 顯示金額$10.00; API金額1000
HUF福林菲勒: 轉換×100; 顯示金額Ft10.00; API金額1000
IDR^*印尼盾-: 轉換×1; 顯示金額Rp1000; API金額1000
JPY日圓-: 轉換×1; 顯示金額¥1000; API金額1000
KES肯亞先令分: 轉換×100; 顯示金額KSh10.00; API金額1000
KRW韓元-: 轉換×1; 顯示金額₩1000; API金額1000
KWD科威特丁那費爾: 轉換×1000; 顯示金額د.ك10.000; API金額10000
LKR斯里蘭卡盧比分: 轉換×100; 顯示金額௹10.00; API金額1000
MAD摩洛哥迪爾汗生丁: 轉換×100; 顯示金額DH10.00; API金額1000
MXN墨西哥披索分: 轉換×100; 顯示金額Mex$10.00; API金額1000
MYR令吉仙: 轉換×100; 顯示金額RM10.00; API金額1000
NOK挪威克朗歐爾: 轉換×100; 顯示金額kr10.00; API金額1000
NZDNew Zealand Dollar—: 轉換×100; 顯示金額$10.00; API金額1000
OMR阿曼里亞爾派薩: 轉換×1000; 顯示金額﷼10.000; API金額10000
PEN新索爾分: 轉換×100; 顯示金額S/10.00; API金額1000
PHP披索分: 轉換×100; 顯示金額₱10.00; API金額1000
PKR巴基斯坦盧比派薩: 轉換×100; 顯示金額Rs10.00; API金額1000
PLN茲羅提格羅申: 轉換×100; 顯示金額zł10.00; API金額1000
QAR卡達里亞爾迪拉姆: 轉換×100; 顯示金額ر.ق10.00; API金額1000
RON新列伊巴尼: 轉換×100; 顯示金額lei10.00; API金額1000
SAR沙烏地里亞爾哈拉拉: 轉換×100; 顯示金額﷼10.00; API金額1000
SEK瑞典克朗歐爾: 轉換×100; 顯示金額kr10.00; API金額1000
SGD新加坡幣分: 轉換×100; 顯示金額$10.00; API金額1000
THB泰銖撒丹: 轉換×100; 顯示金額฿10.00; API金額1000
TWD^*新臺幣-: 轉換×1; 顯示金額NT$1000; API金額1000
TZSTanzanian Shilling—: 轉換×100; 顯示金額TSh10.00; API金額1000
UGXUgandan Shilling—: 轉換×1; 顯示金額USh1000; API金額1000
USD美元分: 轉換×100; 顯示金額$10.00; API金額1000
VNDVietnamese Dong—: 轉換×1; 顯示金額₫1000; API金額1000

API 格式一致性

重要： API 請求和回應都使用相同的最小單位格式。當您在 API 回應中收到金額值時，它們遵循完全相同的規則：

零小數位貨幣（CLP、IDR、JPY、KRW、TWD、UGX、VND）以其基本單位回傳
三位小數貨幣（BHD、KWD、OMR）以乘以 1000 的值回傳
所有其他貨幣以其最小單位（乘以 100）回傳

這種一致性確保您可以在後續的 API 呼叫中直接使用回應值，無需轉換。

API 範例

以下範例展示了如何在請求和回應中正確格式化不同貨幣的金額：

兩位小數貨幣（USD） - 以分為單位的金額

json

{
  "price": {
    "currency": "USD",
    "amount": 2499
  }
}

零小數位貨幣（JPY） - 按原樣的金額

json

{
  "price": {
    "currency": "JPY",
    "amount": 5000
  }
}

兩位小數貨幣（EUR） - 以分為單位的金額

json

{
  "price": {
    "currency": "EUR",
    "amount": 15050
  }
}

零小數位貨幣（KRW） - 按原樣的金額

json

{
  "price": {
    "currency": "KRW",
    "amount": 50000
  }
}

重要提示

在處理支付之前始終驗證貨幣格式，以避免收取錯誤的金額。
零小數位貨幣絕不應乘以 100。
兩位小數貨幣必須始終轉換為其最小單位。
向使用者顯示金額時，請記得從最小單位轉換回顯示格式。
某些支付方式可能有因貨幣而異的最小和最大金額限制。