Proposer des valeurs par défaut pertinentes pour la boutique
Suggérez un pays et une devise à partir de la connexion du visiteur pour réduire les frictions avant le paiement, sans traiter la localisation déduite de l'IP comme une preuve pour des décisions de taxe, de livraison ou de facturation qui doivent être exactes.
Devise d'affichage et devise de facturation
Utilisez geo.currency pour préremplir la devise d'affichage et le format des prix de la boutique au premier chargement. Traitez-le strictement comme une valeur d'affichage par défaut : le montant réellement facturé doit toujours provenir de votre prestataire de paiement, qui détermine la devise et le taux à partir du moyen de paiement lui-même, et non d'une adresse IP.
Un sélecteur de région, pas un verrouillage de localisation
Affichez le pays suggéré et laissez l'acheteur le modifier. Ne conditionnez pas la visibilité du catalogue, les niveaux de prix ou l'accès au paiement uniquement à un pays déduit de l'IP — un VPN, un proxy d'entreprise ou un acheteur en déplacement peuvent se résoudre à un endroit depuis lequel ils ne souhaitent pas réellement acheter.
Messages de livraison indicatifs
Les champs city et region permettent d'afficher un message approximatif du type « expédition généralement en 3 à 5 jours vers votre région », et non une date de livraison ou un coût d'expédition garantis. Confirmez l'adresse réelle et le devis de livraison lors du paiement, où l'acheteur les fournit lui-même.
Exemple : suggérer une devise, recalculer au moment du paiement
Au chargement de la page, appelez GET /v1/geo depuis le JavaScript de la boutique, lisez country et currency, puis préremplissez le sélecteur de devise et les prix affichés. Au moment du paiement, écartez la devise déduite de l'IP et utilisez à la place celle que détermine votre prestataire de paiement à partir du moyen de paiement et de l'adresse de facturation de l'acheteur.
Ce que cela ne garantit pas
Les champs actuels ne calculent ni taux de change, ni taxe de vente, ni TVA, et n'établissent pas la résidence fiscale de l'acheteur — le champ de taxe lui-même renvoie un taux null pour les adresses américaines, précisément parce que la taxe de vente américaine basée sur la destination ne peut pas être déterminée à partir du seul pays/région. Utilisez un moteur de taxation dédié et votre prestataire de paiement pour tout ce qui doit être exact au moment du paiement.