サポートされている通貨

Tokenz チェックアウトがサポートする通貨と、各通貨の金額を正しくフォーマットする方法について説明します。

サポート通貨一覧

Tokenz チェックアウトは、アジア太平洋、ヨーロッパ、北米、中東、ラテンアメリカ、アフリカ、南アジアの各地域の通貨をサポートしています。サポート対象通貨の一覧は以下のとおりです：

通貨を探す

地域

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米ドル$

中東の通貨

AEDUAEディルハムد.إ
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 をゼロ小数桁の通貨として扱います。これは、これらを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 倍する必要があります。

通貨最小単位の完全リファレンス

×1小数点以下0桁 · 金額をそのまま使用

×100小数点以下2桁 · 100倍

×1000小数点以下3桁 · 1,000倍

通貨を探す

45通貨中45通貨

AEDUAEディルハムフィルス: 変換×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）は基本単位のまま返されます
小数点以下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
  }
}

重要な注意事項

誤った金額の請求を避けるため、決済処理前に必ず通貨フォーマットを確認してください。
小数点を持たない通貨を 100 倍にしてはいけません。
小数点以下2桁の通貨は、必ず最小単位に変換してください。
ユーザーに金額を表示する際は、最小単位から表示用のフォーマットへの変換を忘れないでください。
一部の決済手段では、通貨ごとに最小金額・最大金額の制限が異なります。