関連性の高いストアフロントの初期設定を提供する
訪問者の接続情報から国と通貨を提案し、チェックアウト前の摩擦を減らします。ただし、正確性が求められる税務・配送・請求の判断において、IP由来の位置情報を証拠として扱わないでください。
表示用通貨と請求用通貨
geo.currencyを使って、初回読み込み時にストアフロントの表示通貨と価格表示を初期設定してください。これは厳密に表示用の初期値として扱ってください:実際に請求される金額は、決済方法自体から通貨とレートを解決する決済代行会社から取得する必要があり、IPアドレスから取得するものではありません。
地域セレクターであって、位置のロックではない
提案された国を表示し、購入者が変更できるようにしてください。カタログの表示、価格帯、チェックアウトへのアクセスを、IP由来の国だけを根拠に制限しないでください—VPN、企業プロキシ、旅行中の購入者は、実際に購入を希望していない場所に解決される可能性があります。
暫定的な配送メッセージ
cityとregionのフィールドは、「通常お住まいの地域には3〜5日でお届けします」のようなおおよそのメッセージには使えますが、配送日や配送コストを保証するものではありません。実際の住所と配送見積もりは、購入者が直接入力するチェックアウト時に確認してください。
例:通貨を提案し、チェックアウト時に再計算する
ページ読み込み時に、ストアフロント自身のJavaScriptからGET /v1/geoを呼び出し、countryとcurrencyを取得して、通貨セレクターと表示価格を初期設定します。チェックアウト時には、IP由来の通貨を使わず、購入者の決済方法と請求先住所から決済代行会社が解決する通貨を使用してください。
これによって保証されないこと
現在のフィールドは為替レート、消費税、VATを計算せず、購入者の請求先の居住地を確定するものでもありません—実際、tax(税務)フィールド自体は、送付先ベースの米国の売上税が国・地域のみから解決できないため、米国の住所に対して常にnullのレートを返します。チェックアウト時に正確性が求められる処理には、専用の税務エンジンと決済代行会社をご利用ください。