Mostrar avisos de pago por IP en WooCommerce

Autor:Lisa Farrell · 2026-06-01

Las tiendas WooCommerce pueden mostrar avisos de pago distintos según la región del visitante. PHP inserta el contenedor y el navegador reemplaza el mensaje según el país.

Explicación de la API

Una llamada del navegador comprueba la IP del visitante y devuelve su IP, país, región y ciudad. Es adecuada para mostrar contenido localizado.

{"ip":"185.220.236.7","country":"TW","region":"Taiwan","city":"Taipei"}

Casos de uso

Estos casos muestran el valor de la interfaz de información IP y separan claramente IP del servidor e IP del visitante.

  • Estos casos muestran el valor de la interfaz de información IP y separan claramente IP del servidor e IP del visitante.
  • Mostrar avisos de pago por IP en WooCommerce
  • Explicación de la API
  • Recomendaciones SEO y UX

Lógica de implementación

Antes de implementar, identifique el solicitante: las solicitudes del servidor devuelven IP del servidor y las del navegador devuelven IP del visitante.

  • Antes de implementar, identifique el solicitante: las solicitudes del servidor devuelven IP del servidor y las del navegador devuelven IP del visitante.
  • Una llamada del navegador comprueba la IP del visitante y devuelve su IP, país, región y ciudad. Es adecuada para mostrar contenido localizado.
  • Todos los ejemplos siguientes usan directamente https://my.ipin.io/info, con comentarios y textos de interfaz localizados.
  • El contenido predeterminado debe seguir completo y legible, mientras el contenido regional actúa como mejora. Los buscadores rastrean contenido estable y la página sigue siendo útil si falla la API.

Ejemplo de código

Todos los ejemplos siguientes usan directamente https://my.ipin.io/info, con comentarios y textos de interfaz localizados.

functions.php / plugin

function ipin_geo_payment_notice_html() {
    $box_id = 'ipin-payment-notice-' . wp_generate_uuid4();
    ob_start();
    ?>
    <div id="<?php echo esc_attr($box_id); ?>" class="woocommerce-info ipin-payment-notice">Bienvenido. Este es el contenido predeterminado.</div>
    <script>
    (async function () {
      const el = document.getElementById("<?php echo esc_js($box_id); ?>");
      const defaultText = "Bienvenido. Este es el contenido predeterminado.";
const contentMap = { TW: "Contenido para visitantes de Taiwán", US: "Contenido para visitantes de Estados Unidos", JP: "Contenido para visitantes de Japón" };
try {
  // Llamada del navegador a /info: detecta la IP del visitante.
  const info = await fetch("https://my.ipin.io/info").then(res => res.json());
  el.textContent = contentMap[info.country] || defaultText;
} catch (e) {
  // Mantener el valor predeterminado si falla la solicitud API.
  el.textContent = defaultText;
}
    })();
    </script>
    <?php
    return ob_get_clean();
}
add_action('woocommerce_review_order_before_payment', 'ipin_geo_payment_notice');
function ipin_geo_payment_notice() { echo ipin_geo_payment_notice_html(); }
add_shortcode('geo_payment_notice', 'ipin_geo_payment_notice_shortcode');
function ipin_geo_payment_notice_shortcode() { return ipin_geo_payment_notice_html(); }

Shortcode

[geo_payment_notice]

Recomendaciones SEO y UX

El contenido predeterminado debe seguir completo y legible, mientras el contenido regional actúa como mejora. Los buscadores rastrean contenido estable y la página sigue siendo útil si falla la API.

Errores comunes

Los siguientes puntos afectan la precisión del artículo, la utilidad del código y la credibilidad de la explicación de la API.

  • Los siguientes puntos afectan la precisión del artículo, la utilidad del código y la credibilidad de la explicación de la API.
  • El contenido predeterminado debe seguir completo y legible, mientras el contenido regional actúa como mejora. Los buscadores rastrean contenido estable y la página sigue siendo útil si falla la API.
  • Antes de implementar, identifique el solicitante: las solicitudes del servidor devuelven IP del servidor y las del navegador devuelven IP del visitante.
  • Estos casos muestran el valor de la interfaz de información IP y separan claramente IP del servidor e IP del visitante.

Resumen

Una llamada del navegador comprueba la IP del visitante y devuelve su IP, país, región y ciudad. Es adecuada para mostrar contenido localizado.

Preguntas frecuentes

Las preguntas siguientes fueron redactadas específicamente para este artículo y se relacionan directamente con la implementación.

Pregunta:¿Para qué sirven el Hook y el Shortcode en este artículo?
Respuesta:El Hook muestra el aviso automáticamente en checkout y el Shortcode permite insertarlo en páginas de producto, precios o artículos.
Pregunta:¿Este aviso modifica los métodos de pago de WooCommerce?
Respuesta:No. El código solo muestra información; no habilita, deshabilita ni ordena pasarelas de pago.
Pregunta:¿Por qué la API se llama desde el navegador?
Respuesta:Porque el aviso debe adaptarse a la IP del visitante, y esa IP se obtiene correctamente desde el navegador.
Pregunta:¿El mensaje de pago puede contener enlaces?
Respuesta:Sí, pero si el contenido viene del administrador debe filtrarse para permitir solo HTML seguro.
Pregunta:¿La caché del checkout puede mostrar avisos incorrectos?
Respuesta:Sí. El checkout de WooCommerce normalmente no debe almacenarse en caché de página completa.