--- title: "サポートされている通貨" description: "Tokenz チェックアウトがサポートする通貨と、各通貨の金額を正しくフォーマットする方法について説明します。" source: "https://docs.tokenz.one/ja/v2/checkout/currency" api_version: "v2" locale: "ja" version_status: "current" docs_stage: "prod" --- # サポートされている通貨 Tokenz チェックアウトがサポートする通貨と、各通貨の金額を正しくフォーマットする方法について説明します。 ## サポート通貨一覧 Tokenz チェックアウトは、アジア太平洋、ヨーロッパ、北米、中東、ラテンアメリカ、アフリカ、南アジアの各地域の通貨をサポートしています。サポート対象通貨の一覧は以下のとおりです: ### アジア太平洋地域の通貨 - **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** - UAEディルハム (د.إ) - **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 をゼロ小数桁の通貨として扱います。これは、これらを2桁小数として扱う ISO 4217 の規約とは異なります。JPY、KRW、CLP は Tokenz でも ISO 4217 でもゼロ小数桁として扱われます。 ## 通貨の最小単位 Tokenz API で金額を指定する際は、**ほとんどの通貨は主単位ではなく最小単位**(セント、パイサなど)で指定する必要がある点にご注意ください。これにより、金額の誤りを防ぎ、正確な決済処理が可能になります。 ### 最小単位の仕組み 世界のほとんどの通貨は、主単位を 100 の最小単位に分割する 10 進法を採用しています: - 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 では2桁小数として規定されています。下の参照表ではアスタリスク(`*`)で示されます。 ### 小数点以下3桁の通貨 一部の通貨は、標準的な小数点以下2桁ではなく、小数点以下3桁を使用します。これらの通貨では金額を 1000 倍する必要があります: - **BHD** - バーレーンディナール - **KWD** - クウェートディナール - **OMR** - オマーンリアル 例えば、10.500 BHD を請求するには `10500`(10.500 × 1000)を送信します。 その他のサポート通貨はすべて最小単位を使用するため、金額を 100 倍する必要があります。 ### 通貨最小単位の完全リファレンス | 通貨 | コード | 最小単位名 | 変換 | 例 | | --- | --- | --- | --- | --- | | UAEディルハム | 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 をゼロ小数桁の通貨として扱います。これは、これらを2桁小数として扱う ISO 4217 の規約とは異なります。JPY、KRW、CLP は Tokenz でも ISO 4217 でもゼロ小数桁として扱われます。 ### API フォーマットの一貫性 **重要:** API のリクエストとレスポンスは、いずれも同じ最小単位フォーマットを使用します。API レスポンスで金額を受け取る場合も、同じルールが適用されます: - **小数点を持たない通貨**(CLP、IDR、JPY、KRW、TWD、UGX、VND)は基本単位のまま返されます - **小数点以下3桁の通貨**(BHD、KWD、OMR)は 1000 倍された値で返されます - **その他の通貨**はすべて最小単位(100 倍)で返されます この一貫性により、レスポンスで受け取った値を変換せずに、以降の API リクエストでそのまま使用できます。 ### API 例 以下は、リクエストとレスポンスの両方で、通貨ごとに金額を正しくフォーマットする例です。 小数点以下2桁の通貨(USD) - セント単位の金額 ```json { "price": { "currency": "USD", "amount": 2499 } } ``` 小数点を持たない通貨(JPY) - そのままの金額 ```json { "price": { "currency": "JPY", "amount": 5000 } } ``` 小数点以下2桁の通貨(EUR) - セント単位の金額 ```json { "price": { "currency": "EUR", "amount": 15050 } } ``` 小数点を持たない通貨(KRW) - そのままの金額 ```json { "price": { "currency": "KRW", "amount": 50000 } } ``` ### 重要な注意事項 1. **誤った金額の請求を避けるため、決済処理前に必ず通貨フォーマットを確認**してください。 2. **小数点を持たない通貨**を 100 倍にしてはいけません。 3. **小数点以下2桁の通貨**は、必ず最小単位に変換してください。 4. ユーザーに金額を表示する際は、最小単位から表示用のフォーマットへの変換を忘れないでください。 5. 一部の決済手段では、通貨ごとに最小金額・最大金額の制限が異なります。