Ofereça predefinições relevantes na loja
Sugira um país e moeda a partir da ligação do visitante para reduzir o atrito antes do checkout, sem tratar a localização derivada do IP como prova para decisões de imposto, envio ou faturação que precisam de estar corretas.
Moeda de visualização versus moeda de faturação
Utilize geo.currency para pré-preencher a moeda apresentada da loja e a formatação de preços no primeiro carregamento. Trate-a estritamente como uma predefinição de visualização: o valor efetivamente cobrado continua a ter de vir do seu processador de pagamentos, que resolve a moeda e a taxa a partir do próprio método de pagamento, não de um endereço IP.
Um seletor de região, não um bloqueio de localização
Mostre o país sugerido e deixe o comprador alterá-lo. Não restrinja a visibilidade do catálogo, os escalões de preço, ou o acesso ao checkout apenas com base num país derivado do IP — uma VPN, um proxy corporativo, ou um comprador em viagem podem resolver para um local a partir do qual não pretendem efetivamente comprar.
Mensagens de envio provisórias
Os campos de cidade e região permitem uma mensagem aproximada como "normalmente enviado em 3–5 dias para a sua região", não uma data de entrega ou custo de envio garantidos. Confirme o endereço real e a cotação de envio durante o checkout, onde o comprador o fornece diretamente.
Exemplo: sugerir a moeda, recalcular no checkout
No carregamento da página, chame GET /v1/geo a partir do próprio JavaScript da loja, leia country e currency, e pré-preencha o seletor de moeda e os preços apresentados. No checkout, descarte a moeda derivada do IP e utilize o que o seu processador de pagamentos resolver a partir do método de pagamento e do endereço de faturação do comprador.
O que isto não garante
Os campos atuais não calculam taxas de câmbio, imposto sobre vendas ou IVA, e não estabelecem a residência de faturação de um comprador — o próprio campo de imposto devolve uma taxa nula para endereços dos EUA precisamente porque o imposto sobre vendas dos EUA, baseado no destino, não pode ser resolvido apenas a partir de país/região. Utilize um motor fiscal dedicado e o seu processador de pagamentos para tudo o que tenha de estar correto no checkout.