---
title: "支持的货币"
description: "了解 Tokenz Checkout 支持哪些货币，以及如何正确格式化每种货币的金额。"
source: "https://docs.tokenz.one/zh-CN/v1/checkout/currency"
api_version: "v1"
locale: "zh-CN"
version_status: "legacy"
docs_stage: "prod"
---

# 支持的货币

了解 Tokenz Checkout 支持哪些货币，以及如何正确格式化每种货币的金额。

## 支持的货币列表

Tokenz 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. 某些支付方式的最小和最大金额限制因货币而异。