
El widget de Atli te permite añadir a tu web una tienda completa de eSIM de viaje con una sola etiqueta script. Los visitantes pueden buscar destinos, comparar planes, realizar el pago y recibir el código QR de su eSIM sin salir de tu página. Tu código de socio va incluido en el script para que las compras que cumplan los requisitos se atribuyan a tu cuenta.
Integrarlo no cuesta nada y no requiere ningún paso de compilación. Atli se encarga del catálogo, del pago y de la entrega de la eSIM. La instalación solo requiere un contenedor y una etiqueta script.
Esta página lleva el widget real:
Añadir el widget a una página
Inicia sesión en partners.heyatli.com y abre Integraciones. La tarjeta Widget integrado muestra el código para tu web con tu código de socio ya incluido. Personalizar abre el creador de widgets en partners.heyatli.com/es/dev/atli-widget, donde puedes cambiar cada ajuste y volver a copiar el código.

Si prefieres añadir el código directamente, sustituye YOUR_CODE por tu código de socio:
<div id="heyatli-esim-checkout-container"></div>
<script
src="https://embed.heyatli.com/embed.js"
data-atli-widget
data-target="#heyatli-esim-checkout-container"
data-referral="YOUR_CODE"
defer
></script>Pégalo en el HTML de tu página justo donde quieras que aparezca la tienda. El widget ocupa todo el ancho de su contenedor y crece hasta la altura de lo que esté mostrando. No hay que fijar ninguna altura. Si quitas el <div> y data-target, aparece justo después de la etiqueta script.
El script pesa unos 17 KB y no necesita que instales nada más. Carga la tienda en un iframe servido desde embed.heyatli.com, y ese iframe no puede leer tu página, sus cookies ni su almacenamiento. Los datos de la tarjeta se escriben en el formulario de pago de Stripe que hay dentro del iframe.
Abrir el widget en un destino
En las páginas dedicadas a un país, puedes configurar el widget para que muestre los planes de ese destino. Esta versión se abre en Japón para una guía en alemán y muestra los precios en euros:
<div id="japan-esim"></div>
<script
src="https://embed.heyatli.com/embed.js"
data-atli-widget
data-target="#japan-esim"
data-referral="YOUR_CODE"
data-destination="jp"
data-lang="de"
data-lang-priority="widget"
data-currency="EUR"
defer
></script>
data-destination acepta un código de país de dos letras (jp), el nombre de un país en cualquiera de los idiomas del widget (Japan, 日本), una región (europe, south_east_asia) o el ID de un plan. Un ID de plan abre directamente el pago de ese plan. El widget solo abre un destino cuando encuentra una coincidencia válida. Si no la encuentra, muestra la pantalla de inicio predeterminada. Sea como sea, los visitantes pueden seguir buscando cualquier destino.
data-favorites llena la pestaña Top con hasta 32 destinos elegidos por ti y los mantiene en el orden en que los escribas. Por ejemplo: data-favorites="jp, kr, tw, asia".
Ajustes del widget
Todos los ajustes son opcionales. En la etiqueta script, cada uno es un atributo data-. En JavaScript es el mismo nombre en camelCase: data-lang-priority pasa a ser langPriority.
| Atributo | Qué hace |
|---|---|
data-referral | Tu código de socio. Los clientes nuevos que compran quedan vinculados a ti. |
data-destination | Abre el widget en un destino o un plan. |
data-favorites | Hasta 32 destinos para la pestaña Top, separados por comas. |
data-lang | El idioma del widget. Si falta, se usa el idioma del navegador del visitante. |
data-lang-priority | widget mantiene tu idioma aunque el visitante haya elegido otro y oculta el menú de idiomas. |
data-currency | La moneda de los precios y del pago. USD por defecto. |
data-currency-priority | widget mantiene tu moneda aunque el visitante haya elegido otra. |
data-theme | light o dark. Si falta, se usa el ajuste del dispositivo del visitante. |
data-theme-priority | widget mantiene tu tema y oculta el ajuste de tema. |
data-css | La dirección https:// de tu propia hoja de estilos para el widget. |
data-boot | Abre el widget en una de las pantallas del propio visitante: esims, credits, vouchers, refer, settings, payment-methods, groups o profile. esim abre la página de instalación de la eSIM compartida cuyo código pasas en data-lpa, y esa página no pide cuenta. |
data-anonymous-cards | true permite que los visitantes sin sesión iniciada guarden una tarjeta en ese navegador. Desactivado por defecto. |
data-stripe-link | false quita Stripe Link del formulario de pago. |
data-analytics | off impide que el widget cargue su propia analítica. |
data-consent | all, analytics o none, según lo que haya recogido tu banner de cookies. |
data-env | staging ejecuta el widget en el Sandbox de Atli. No lo pongas en una página publicada. |
El widget admite 15 idiomas: en inglés, pt portugués, es español, fr francés, it italiano, de alemán, pl polaco, ru ruso, zh chino, ko coreano, ja japonés, id indonesio, vi vietnamita, ms malayo y ar árabe. Muestra los precios en AUD, CAD, EUR, GBP, HKD, JPY, KRW, SGD, TWD, USD y VND. Los valores no admitidos se ignoran. Por ejemplo, con data-currency="EUROS" el widget usa USD por defecto.
El widget en una aplicación de una sola página
La etiqueta script inicializa el widget al cargar la página, pero no responde automáticamente a los cambios de ruta de tu aplicación. En React, Vue, Next.js o cualquier app que cambie de página sin recargar, carga el script una sola vez en tu HTML y monta el widget desde tu código:
<script src="https://embed.heyatli.com/embed.js"></script>const widget = HeyAtli.init({
target: '#esim',
referral: 'YOUR_CODE',
destination: 'jp',
lang: 'de',
currency: 'EUR',
});
// Change settings later without rebuilding the frame
widget.update({ destination: 'th' });
// Remove it when the page goes away
widget.destroy();target acepta un selector CSS o un elemento. update() combina lo que le pases con los ajustes actuales y no recarga el iframe. En React basta con un efecto:
import { useEffect, useRef } from 'react';
export function EsimStore({ destination }) {
const ref = useRef(null);
useEffect(() => {
const widget = window.HeyAtli.init({
target: ref.current,
referral: 'YOUR_CODE',
destination,
});
return () => widget.destroy();
}, [destination]);
return <div ref={ref} />;
}En desarrollo, el Strict Mode de React ejecuta cada efecto, lo limpia y lo vuelve a ejecutar. Incluye destroy() en la función de limpieza para evitar instancias duplicadas del widget.
Cambiar el estilo con CSS
Pasa a data-css la dirección https:// completa de una hoja de estilos de tu web. El widget la carga dentro de su iframe después de sus propios estilos, así que los selectores normales ganan sin !important. Si el archivo no carga, el widget mantiene su aspecto por defecto.
Hay una línea que queda fuera de tu alcance. Todas las pantallas terminan con un pie Con la tecnología de Atli | Soporte que tu hoja de estilos no puede cambiar ni ocultar. Si una hoja de estilos lo oculta, lo atenúa, lo recorta o lo tapa, el widget la descarta y vuelve a su aspecto por defecto durante el resto de la visita, y la consola del navegador explica por qué.
Empieza por las variables CSS del widget. Los visitantes pueden ver tanto el tema claro como el oscuro, así que define las variables para los dos:
.atli-widget {
--atli-font-family: 'Inter', system-ui, sans-serif;
--atli-color-accent: #0f766e;
--atli-color-accent-hover: #115e59;
--atli-color-accent-text: #ffffff;
--atli-radius-md: 6px;
}
.atli-widget[data-theme='dark'] {
--atli-color-accent: #2dd4bf;
--atli-color-accent-hover: #5eead4;
--atli-color-accent-text: #042f2e;
}sunset.css y mono.css son ejemplos completos y comentados que cubren todas las variables habituales. Los campos de la tarjeta están en el propio iframe de Stripe, donde no llega ninguna hoja de estilos. En su lugar, cuando el widget monta el formulario de pago, le pasa a Stripe tus colores de acento, de texto y de fondo, tu fuente y tu radio de borde.

La personalización con CSS te permite adaptar el widget a la identidad visual de tu web. Para tener un control total de la interfaz, usa la API de Atli, que requiere desarrollo adicional.
Medir las compras con los eventos del widget
El widget emite eventos que tu web puede usar para medir la actividad de los visitantes y las compras. Para enviar las compras a tu analítica, móntalo con HeyAtli.init() y escucha purchase.completed. Este manejador pasa cada compra a Google Tag Manager en el formato de comercio electrónico de GA4:
const widget = HeyAtli.init({ target: '#esim', referral: 'YOUR_CODE' });
widget.on('purchase.completed', function (detail) {
window.dataLayer = window.dataLayer || [];
window.dataLayer.push({ ecommerce: null });
window.dataLayer.push({
event: 'purchase',
ecommerce: {
transaction_id: detail.transactionId,
value: detail.value,
currency: detail.currency,
items: detail.items,
},
});
});items llega en el formato de artículos de GA4, así que entra en el dataLayer tal cual. value va en la unidad principal de la moneda, así que llega como 12.99 y no como 1299. El primer push vacía el objeto ecommerce anterior, algo que Google recomienda antes de cada evento de comercio electrónico.
Entre los demás eventos están checkout.opened, payment.started y payment.failed. Un manejador recibe (detail, info) y en info.action va el nombre del evento, así que widget.on('*', handler) puede reenviarlos todos. Para registrar cada evento en la consola del navegador, añade debug: true a init() o data-debug="true" a la etiqueta script.
Los eventos solo llegan a los dominios de la lista de permitidos de Atli. heyatli.com y localhost están en ella, así que puedes desarrollar en tu propio ordenador. Por eso mismo, un manejador que funciona en localhost puede dejar de recibir eventos en tu web publicada. Pide a [email protected] que añada tu dominio. El widget puede seguir procesando compras aunque el seguimiento de eventos no esté disponible.
Pruebas en Sandbox
Añade data-env="staging" (o env: 'staging' en HeyAtli.init()) para ejecutar el widget en el Sandbox de Atli. En la esquina aparece una etiqueta Sandbox, y tu código de socio se ve atenuado en el banner de prueba para que compruebes que la página lo ha recogido. Paga con la tarjeta de prueba de Stripe 4242 4242 4242 4242, cualquier fecha de caducidad futura y cualquier código de seguridad. Las cuentas de Sandbox son independientes de las reales. Las eSIM de Sandbox vienen de un operador de prueba, así que no se pueden instalar en un móvil, y las ventas en Sandbox nunca generan comisión.
El widget usa el entorno de producción por defecto. Quita data-env="staging" antes de publicar, porque el Sandbox solo acepta pagos de prueba.
Cómo se atribuyen las ventas del widget
Un visitante que compra en el widget queda vinculado a ti cuando inicia sesión o paga, salvo que el código de otro socio o una compra anterior se te hayan adelantado. El widget recuerda tu código en el navegador del visitante durante 72 horas, así que quien vuelve al día siguiente sigue contando. Tras esa primera compra el vínculo es permanente, y las compras posteriores con la misma cuenta de Atli también cuentan para ti.
Los precios son los mismos que en la tienda de Atli, y el descuento de tu código aparece al pagar. Cómo paga el programa de afiliados de Atli explica las ganancias y los pagos.
Preguntas frecuentes
¿El widget de Atli cuesta algo?
¿Necesito mi propia cuenta de Stripe?
¿Los visitantes pueden instalar la eSIM desde el widget?
¿Puedo limitar el widget a los países sobre los que escribo?
data-destination lo abre en un destino y data-favorites llena la pestaña Top con hasta 32 destinos elegidos por ti. Los visitantes pueden seguir buscando en todo el catálogo.¿El widget hará más lenta mi página?
¿Puedo poner dos widgets en una misma página?
HeyAtli.init() una vez por cada contenedor.


