メインコンテンツへスキップ

Documentation Index

Fetch the complete documentation index at: https://waffo.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

​
金額フォーマット

Waffo の金額はすべて String 型 で統一して表します。Number、float、double は使用しないでください。 
✅ "100.00"
✅ "0.99"
✅ "10000"     (JPY などの小数なし通貨)

❌ 100.00      (Number 型 — 浮動小数点精度の問題が発生)
❌ 100         (Number 型)
Number ではなく String を必須としているのは、浮動小数点精度の問題を避けるためです。0.1 + 0.2 = 0.30000000000000004 のような挙動は金融の文脈では許容されません。

​
小数桁数のルール

通貨ごとに必要な小数桁数は異なります。
誤った小数桁数を渡した場合、パラメータエラー (A0003) が返されます。

​
小数 2 桁(大半の通貨)

以下の通貨は、金額をちょうど小数 2 桁で表記する必要があります: 
"100.00"  ✅
"9.99"    ✅
"100"     ❌ (小数桁が不足)
"100.0"   ❌ (小数 1 桁のみ)
地域通貨
アジア太平洋PHP (フィリピン・ペソ), MYR (マレーシア・リンギット), THB (タイ・バーツ), KHR (カンボジア・リエル), SGD (シンガポール・ドル), HKD (香港ドル), MOP (マカオ・パタカ), CNY (中国人民元), AUD (オーストラリア・ドル), MNT (モンゴル・トゥグルグ)
南北アメリカUSD (米ドル), BRL (ブラジル・レアル), MXN (メキシコ・ペソ), PEN (ペルー・ソル), CAD (カナダ・ドル), AWG (アルバ・フロリン)
ヨーロッパ・アフリカEUR (ユーロ), GBP (英ポンド), RUB (ロシア・ルーブル), TRY (トルコ・リラ), PLN (ポーランド・ズロチ), SEK (スウェーデン・クローナ), NGN (ナイジェリア・ナイラ)
暗号資産USDC, USDT

​
小数 0 桁(小数なし)

以下の通貨では 小数点を含めてはいけません: 
"1000"    ✅
"1000.00" ❌ (小数は不可)
"999.50"  ❌ (小数は不可)
通貨名称
JPY日本円
KRW韓国ウォン
VNDベトナム・ドン
CLPチリ・ペソ

​
特殊通貨(同一通貨注文は 0 桁、クロス通貨注文は 2 桁)

以下の通貨は、同一通貨注文では小数不可ですが、クロス通貨注文では小数 2 桁が許容されます:
通貨名称同一通貨注文クロス通貨注文
IDRインドネシア・ルピア"10000" ✅ / "10000.50" ❌"10000.50" ✅
COPコロンビア・ペソ"5000" ✅ / "5000.00" ❌"5000.00" ✅
KESケニア・シリング"100" ✅ / "100.50" ❌"100.50" ✅
TWD新台湾ドル"300" ✅ / "300.00" ❌"300.00" ✅

​
同一通貨注文とクロス通貨注文

シナリオ例説明
同一通貨商品が IDR 建て、ユーザーが DANA (IDR) で支払いorderCurrency がユーザーの決済通貨と一致
クロス通貨商品が USD 建て、ユーザーが DANA (IDR) で支払いorderCurrency がユーザーの決済通貨と異なる

​
クロス通貨注文のパラメータ

{
  "orderCurrency": "USD",
  "orderAmount": "10.00"
}
クロス通貨のシナリオでは userCurrency は任意です。ただし、payMethodType または payMethodName が完全に指定されていない場合は、ユーザーがどの国にいるかを Waffo に伝えるために payMethodCountry を渡してください。 為替換算は Waffo が自動的に処理します。ユーザーはチェックアウトページでローカル通貨の金額を確認できます。

​
通貨一覧

通貨コード名称小数桁数備考
IDRインドネシア・ルピア0 / 2同一通貨: 0、クロス通貨: 2
USD米ドル2
PHPフィリピン・ペソ2
BRLブラジル・レアル2
MXNメキシコ・ペソ2
MYRマレーシア・リンギット2
THBタイ・バーツ2
CADカナダ・ドル2
EURユーロ2
AUDオーストラリア・ドル2
GBP英ポンド2
VNDベトナム・ドン0小数なし
CLPチリ・ペソ0小数なし
COPコロンビア・ペソ0 / 2同一通貨: 0、クロス通貨: 2
PENペルー・ソル2
RUBロシア・ルーブル2
KESケニア・シリング0 / 2同一通貨: 0、クロス通貨: 2
NGNナイジェリア・ナイラ2
TWD新台湾ドル0 / 2同一通貨: 0、クロス通貨: 2
HKD香港ドル2
JPY日本円0小数なし
KRW韓国ウォン0小数なし
MOPマカオ・パタカ2
SGDシンガポール・ドル2
CNY中国人民元2
PLNポーランド・ズロチ2
TRYトルコ・リラ2
KHRカンボジア・リエル2
SEKスウェーデン・クローナ2
AWGアルバ・フロリン2
MNTモンゴル・トゥグルグ2
USDCUSD Coin2暗号資産
USDTTether2暗号資産