海外収納の金額を統一する:通貨コード、金額単位とローカライズ表示
画面価格、内部金額とチャネル項目の表現は同じとは限りません。通貨と単位を確認してから変換します。対象地域とD0条件は合意した内容に従い、公開例からすべての海外チャネルの単位を推測しません。
テーマ別に読む
1.金額に通貨と単位を付ける
通貨コード、内部単位、精度と見積版を保存し、文脈のない1000だけを残しません。注文ごとの通貨と金額を固定し、不明な単位や未対応設定は作成前に止めます。CNYやUSDTを自動補完しません。
主単位、補助単位とトークン最小単位は異なります。表示小数や国名だけではAPI単位は決まりません。要求、照会と通知の単位や丸めをチャネルごとに確認し、例の矛盾を推測で埋めません。
2.地域別の数値形式は表示に使う
価格を地域別形式で表示しても、1,000や1.000の解釈は慣習によって異なります。記号を一律に削除したり、整形済み文字列を正しい内部金額としたりしません。
信頼する商品と見積から値を作り、実際の仕様で符号化します。金額比較には明確な精度の十進値や整数単位を使い、二進浮動小数の誤差に注意します。符号、範囲、桁数と通貨も検証します。表示APIが料金規則を決めるわけではありません。
3.見積を固定し変換版を残す
内部USD10.50を1050にするのは、そのチャネルがセントを要求すると明記されている場合だけです。主単位の文字列ならその仕様に従います。VND、INRや別のUSDチャネルへ同じ変換をコピーしません。
内部値、送信値、単位と変換版を保存し、通知や照会を逆変換して元注文と比べます。言語や現価変更で旧リンクの意味を変えません。100倍の差が出ても自動で割らず、原文を残して保留・確認します。
4.原通貨、USDTと権利を別々に照合する
原通貨は支払、費用、返金と未精算、USDTは合意換算、送金と実受取を説明します。精算事項で結び、異なる通貨を直接引いたりUSDとUSDTを同額と決めたりしません。D0は単位、レートや着金分数を決めません。
書籍コイン、ポイント、通信量や会員権は元商品から提供します。模擬データで区切り、ゼロ、負値、過剰精度、通貨欠落、単位矛盾と言語変更を検証し、表示から決済・精算まで追跡できることを確認します。
よくある質問
小数二桁ならAPIは必ず補助単位ですか。
表示、通貨慣習とAPI単位は別です。チャネルの実仕様を確認してください。
通知額が100倍なら自動で割ってよいですか。
原通知を保存し、加盟店、チャネルと変換版の単位を技術担当と確認してから修正します。