---
title: "支援的貨幣"
description: "了解 Tokenz Checkout 支援的貨幣以及如何正確格式化每種貨幣的金額值。"
source: "https://docs.tokenz.one/zh-TW/v2/checkout/currency"
api_version: "v2"
locale: "zh-TW"
version_status: "current"
docs_stage: "prod"
---

# 支援的貨幣

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

## 支援的貨幣清單

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

### 亞太地區貨幣

- **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)

### Other currencies

- **NZD** - New Zealand Dollar ($)
- **TZS** - Tanzanian Shilling (TSh)
- **UGX** - Ugandan Shilling (USh)
- **VND** - Vietnamese 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。

### 貨幣最小單位完整參考

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

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

### 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
  }
}
```

### 重要提示

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