Ofrece valores predeterminados relevantes en la tienda
Sugiere un país y una moneda a partir de la conexión del visitante para reducir la fricción antes del checkout, sin tratar la ubicación derivada de la IP como evidencia para decisiones de impuestos, envío o facturación que deben ser correctas.
Moneda de visualización frente a moneda de facturación
Usa geo.currency para prellenar la moneda mostrada de la tienda y el formato de precios en la primera carga. Trátalo estrictamente como un valor predeterminado de visualización: el monto realmente cobrado debe provenir de tu procesador de pagos, que resuelve la moneda y la tasa a partir del propio método de pago, no de una dirección IP.
Un selector de región, no un bloqueo de ubicación
Muestra el país sugerido y permite que el comprador lo cambie. No condiciones la visibilidad del catálogo, los niveles de precios ni el acceso al checkout únicamente a un país derivado de la IP — una VPN, un proxy corporativo o un comprador en viaje pueden resolver a un lugar desde el que en realidad no quieren comprar.
Mensajes de envío tentativos
Los campos de ciudad y región permiten un mensaje aproximado como "suele enviarse en 3–5 días a tu región", no una fecha de entrega ni un costo de envío garantizados. Confirma la dirección real y la cotización de envío durante el checkout, donde el comprador la proporciona directamente.
Ejemplo: sugiere la moneda, recalcula en el checkout
Al cargar la página, llama a GET /v1/geo desde el propio JavaScript de la tienda, lee country y currency, y prellena el selector de moneda y los precios mostrados. En el checkout, descarta la moneda derivada de la IP y usa lo que tu procesador de pagos resuelva a partir del método de pago y la dirección de facturación del comprador.
Lo que esto no garantiza
Los campos actuales no calculan tasas de cambio, impuestos sobre ventas ni IVA, y no establecen la residencia fiscal de un comprador — el propio campo tax devuelve una tasa nula para direcciones de EE. UU. precisamente porque el impuesto de ventas de EE. UU. basado en el destino no puede resolverse solo con país/región. Usa un motor fiscal dedicado y tu procesador de pagos para todo lo que deba ser correcto en el checkout.