--- title: "支援的貨幣" description: "查詢支援的貨幣,以及 API 應填入的整數金額。 查詢貨幣." source: "https://docs.tokenz.one/zh-TW/v3/checkout/currency" api_version: "v3" locale: "zh-TW" version_status: "current" docs_stage: "prod" --- # 支援的貨幣 查詢支援的貨幣,以及 API 應填入的整數金額。 [查詢貨幣](https://docs.tokenz.one/zh-TW/v3/checkout/currency#%E6%94%AF%E6%8F%B4%E7%9A%84%E8%B2%A8%E5%B9%A3%E6%B8%85%E5%96%AE). ## 貨幣最小單位 金額以整數傳送。例如,USD 10.99 填入 `1099`;JPY 1,000 直接填入 `1000`。 ### 最小單位的運作原理 | 換算 | 顯示金額 → API 金額 | | --- | --- | | ×1 · 零小數位貨幣 | JPY 1,000 → `1000` | | ×100 · 其他支援的貨幣 | USD 10.99 → `1099` | | ×1,000 · 三位小數貨幣 | BHD 10.500 → `10500` | > **Tokenz 特例:** ISO 4217 將 IDR 和 TWD 定義為兩位小數,但 Tokenz API 使用 ×1。傳送 API 金額時,請以 Tokenz 的換算規則為準。 ### 零小數位貨幣 以下貨幣直接填入金額,不需換算: | 代碼 | 貨幣 | | --- | --- | | `CLP` | 智利披索 | | `IDR` | 印尼盾 | | `JPY` | 日圓 | | `KRW` | 韓元 | | `TWD` | 新臺幣 | | `UGX` | 烏干達先令 | | `VND` | 越南盾 | ### 三位小數貨幣 以下貨幣需將顯示金額乘以 1,000: | 代碼 | 貨幣 | | --- | --- | | `BHD` | 巴林迪納 | | `KWD` | 科威特丁那 | | `OMR` | 阿曼里亞爾 | ### API 格式一致性 請求與回應使用相同的整數格式。回應中的金額可直接用於後續 API 呼叫,不需再次換算。 ### API 範例 以下價格表示收取 USD 24.99: ```json { "price": { "currency": "USD", "amount": 2499 } } ``` ### 重要提示 - 向顧客顯示金額時,請先將 API 金額除以換算係數。 - 各付款方式可能對同一貨幣設定不同的最低與最高金額。 ## 支援的貨幣清單 依代碼、貨幣名稱或符號搜尋。換算係數與範例說明每種貨幣應填入的 API 金額。 ### 貨幣最小單位完整參考 | 貨幣 | 代碼 | 最小單位名稱 | 轉換 | 範例 | 地區 | | --- | --- | --- | --- | --- | --- | | 阿聯酋迪拉姆 | 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 | 歐洲貨幣 | | 紐西蘭元 | 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 | 亞太地區貨幣 | | 坦尚尼亞先令 | TZS | 分 | ×100 | TSh10.00 = 1000 | 其他貨幣 | | 烏干達先令 | UGX | - | ×1 | USh1000 = 1000 | 其他貨幣 | | 美元 | USD | 分 | ×100 | $10.00 = 1000 | 北美貨幣 | | 越南盾 | VND | - | ×1 | ₫1000 = 1000 | 其他貨幣 | \* Tokenz 將 IDR, TWD 視為零小數位貨幣。這與將其視為兩位小數的 ISO 4217 規約不同。JPY、KRW 和 CLP 在 Tokenz 和 ISO 4217 中均為零小數位貨幣。