Skip to main content

金額フォーマット

Waffo の金額はすべて String 型 で統一して表します。Number、float、double は使用しないでください。
Number ではなく String を必須としているのは、浮動小数点精度の問題を避けるためです。0.1 + 0.2 = 0.30000000000000004 のような挙動は金融の文脈では許容されません。

小数桁数のルール

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

小数 2 桁(大半の通貨)

以下の通貨は、金額をちょうど小数 2 桁で表記する必要があります:

小数 0 桁の通貨

以下の通貨の小数桁数は 0 桁です。VND の場合、小数部を省略するか、すべて 0 にできます。小数部に 0 以外の数字が含まれると、金額の検証に失敗します。

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

以下の通貨は、同一通貨注文では小数不可ですが、クロス通貨注文では小数 2 桁が許容されます:

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

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

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

通貨一覧