
Le widget Atli vous permet d’ajouter à votre site une boutique complète d’eSIM de voyage avec une seule balise script. Les visiteurs peuvent rechercher des destinations, comparer les forfaits, effectuer leur paiement et recevoir le QR code de leur eSIM sans quitter votre page. Votre code partenaire est inclus dans le script afin que les achats éligibles soient attribués à votre compte.
Son intégration est gratuite et ne demande aucune étape de build. Atli gère le catalogue, le paiement et la livraison de l’eSIM. L’installation ne nécessite qu’un conteneur et une balise script.
Cette page intègre le vrai widget :
Ajouter le widget à une page
Connectez-vous sur partners.heyatli.com et ouvrez Intégrations. Sur la carte Widget intégré, le code pour votre site contient déjà votre code partenaire. Le bouton Personnaliser ouvre le configurateur du widget sur partners.heyatli.com/fr/dev/atli-widget, où vous pouvez modifier chaque réglage et copier à nouveau le code.

Si vous préférez ajouter le code directement, remplacez YOUR_CODE par votre code partenaire :
<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>Collez-le dans le HTML de votre page là où la boutique doit apparaître. Le widget prend toute la largeur de son conteneur et adopte la hauteur de ce qu’il affiche. Il n’y a aucune hauteur à définir. Si vous omettez le <div> et data-target, il apparaît juste après la balise script.
Le script pèse environ 17 Ko et ne demande rien d’autre à installer. Il charge la boutique dans une iframe servie par embed.heyatli.com, et cette iframe ne peut lire ni votre page, ni ses cookies, ni son stockage. Les données de carte se saisissent dans le formulaire de paiement de Stripe que contient l’iframe.
Ouvrir le widget sur une destination
Pour les pages consacrées à un pays, vous pouvez configurer le widget pour qu’il affiche les forfaits de cette destination. Cette version s’ouvre sur le Japon pour un guide en allemand et affiche les prix 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 accepte un code pays à deux lettres (jp), un nom de pays dans l’une des langues du widget (Japan, 日本), une région (europe, south_east_asia) ou un identifiant de forfait. Un identifiant de forfait ouvre le paiement de ce forfait. Le widget n’ouvre une destination que s’il trouve une correspondance valide. Sinon, il affiche l’écran d’accueil par défaut. Dans un cas comme dans l’autre, les visiteurs peuvent toujours chercher parmi toutes les destinations.
data-favorites remplit l’onglet Top avec jusqu’à 32 destinations de votre choix et les garde dans l’ordre où vous les indiquez. Par exemple : data-favorites="jp, kr, tw, asia".
Réglages du widget
Tous les réglages sont facultatifs. Dans la balise script, chacun prend la forme d’un attribut data-. En JavaScript, c’est le même nom en camelCase : data-lang-priority devient langPriority.
| Attribut | Effet |
|---|---|
data-referral | Votre code partenaire. Les nouveaux clients qui achètent vous sont rattachés. |
data-destination | Ouvre le widget sur une destination ou un forfait. |
data-favorites | Jusqu’à 32 destinations séparées par des virgules pour l’onglet Top. |
data-lang | La langue du widget. Sans cet attribut, le widget prend la langue du navigateur du visiteur. |
data-lang-priority | widget garde votre langue même si le visiteur en a choisi une autre, et masque le menu des langues. |
data-currency | La devise des prix et du paiement. USD par défaut. |
data-currency-priority | widget garde votre devise même si le visiteur en a choisi une autre. |
data-theme | light ou dark. Sans cet attribut, le widget suit le réglage de l’appareil du visiteur. |
data-theme-priority | widget garde votre thème et masque le réglage du thème. |
data-css | L’adresse https:// de votre propre feuille de style pour le widget. |
data-boot | Ouvre le widget sur l’un des écrans personnels du visiteur : esims, credits, vouchers, refer, settings, payment-methods, groups ou profile. esim ouvre sans compte la page d’installation de l’eSIM partagée dont vous indiquez le code dans data-lpa. |
data-anonymous-cards | true permet aux visiteurs non connectés d’enregistrer une carte dans ce navigateur. Désactivé par défaut. |
data-stripe-link | false retire Stripe Link du formulaire de paiement. |
data-analytics | off empêche le widget de charger sa propre mesure d’audience. |
data-consent | Reprend le consentement recueilli par votre bandeau de cookies : all, analytics ou none. |
data-env | staging fait tourner le widget sur l’environnement Sandbox d’Atli. Retirez-le sur une page en ligne. |
Le widget prend en charge 15 langues : en anglais, pt portugais, es espagnol, fr français, it italien, de allemand, pl polonais, ru russe, zh chinois, ko coréen, ja japonais, id indonésien, vi vietnamien, ms malais et ar arabe. Il affiche les prix en AUD, CAD, EUR, GBP, HKD, JPY, KRW, SGD, TWD, USD et VND. Les valeurs non prises en charge sont ignorées. Par exemple, avec data-currency="EUROS", les prix s’affichent en USD par défaut.
Ajouter le widget à une application monopage
La balise script initialise le widget au chargement de la page, mais elle ne réagit pas automatiquement aux changements de route de votre application. Avec React, Vue, Next.js ou toute application qui change de page sans rechargement, chargez le script une fois dans votre HTML et montez le widget depuis votre code :
<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 accepte un sélecteur CSS ou un élément. update() fusionne ce que vous lui passez avec les réglages en cours et ne recharge pas l’iframe. En React, le widget trouve sa place dans un effet :
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 développement, le Strict Mode de React exécute chaque effet, le nettoie puis l’exécute à nouveau. Incluez destroy() dans la fonction de nettoyage pour éviter les instances en double du widget.
Styliser le widget en CSS
Donnez à data-css l’adresse https:// complète d’une feuille de style hébergée sur votre site. Le widget la charge dans son iframe après ses propres styles : de simples sélecteurs l’emportent donc sans !important. Si le fichier ne se charge pas, le widget garde son apparence par défaut.
Une ligne reste hors de portée. Chaque écran se termine par le pied de page Propulsé par Atli | Assistance, que votre feuille de style ne peut ni modifier ni masquer. Une feuille de style qui le masque, l’estompe, le rogne ou le recouvre est écartée, le widget reprend son apparence par défaut pour le reste de la visite, et la console du navigateur en donne la raison.
Commencez par les variables CSS du widget. Les visiteurs peuvent voir le thème clair comme le thème sombre. Définissez les variables pour les deux :
.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 et mono.css sont des exemples complets et commentés qui couvrent toutes les variables courantes. Les champs de carte se trouvent dans l’iframe de Stripe, qu’aucune feuille de style ne peut atteindre. Quand le widget construit le formulaire de paiement, il transmet plutôt à Stripe vos couleurs d’accent, de texte et de surface, votre police et votre arrondi des angles.

La personnalisation CSS vous permet d’adapter le widget à l’identité visuelle de votre site. Pour un contrôle complet de l’interface, utilisez l’API Atli, qui demande un développement supplémentaire.
Suivre les achats avec les événements du widget
Le widget émet des événements que votre site peut utiliser pour suivre l’activité des visiteurs et leurs achats. Pour envoyer les achats vers votre outil d’analyse, montez le widget avec HeyAtli.init() et écoutez purchase.completed. Ce gestionnaire transmet chaque achat à Google Tag Manager au format e-commerce 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 arrive au format d’article de GA4 et va donc tel quel dans le dataLayer. value est exprimé dans l’unité principale de la devise et vaut 12.99 plutôt que 1299. Le premier push vide l’objet ecommerce précédent, ce que Google recommande avant chaque événement e-commerce.
Parmi les autres événements figurent checkout.opened, payment.started et payment.failed. Un gestionnaire reçoit (detail, info), et info.action donne le nom de l’événement : widget.on('*', handler) peut donc tous les relayer. Pour journaliser chaque événement dans la console du navigateur, ajoutez debug: true à init() ou data-debug="true" à la balise script.
Les événements n’atteignent que les domaines inscrits sur la liste d’autorisation d’Atli. Le domaine heyatli.com et localhost y figurent : vous pouvez donc développer sur votre propre machine. C’est aussi pourquoi un gestionnaire qui fonctionne sur localhost peut cesser de recevoir les événements sur votre site en production. Demandez à [email protected] d’ajouter votre domaine. Le widget peut continuer à traiter les achats même si le suivi des événements n’est pas disponible.
Tester sur Sandbox
Pour faire tourner le widget sur l’environnement Sandbox d’Atli, ajoutez data-env="staging" à la balise script ou env: 'staging' dans HeyAtli.init(). Une étiquette Sandbox s’affiche dans un coin, et votre code partenaire apparaît en filigrane dans le bandeau de test pour que vous puissiez vérifier que la page l’a bien repris. Payez avec la carte de test de Stripe 4242 4242 4242 4242, n’importe quelle date d’expiration future et n’importe quel code de sécurité. Les comptes Sandbox sont distincts des comptes réels. Les eSIM Sandbox proviennent d’un opérateur de test : elles ne peuvent donc pas être installées sur un téléphone, et les ventes Sandbox ne rapportent jamais de commission.
Le widget utilise l’environnement de production par défaut. Retirez data-env="staging" avant de publier, car l’environnement Sandbox n’accepte que les paiements de test.
Comment les ventes du widget vous sont attribuées
Un visiteur qui achète dans le widget vous est rattaché quand il se connecte ou paie, sauf si le code d’un autre partenaire ou un achat antérieur est arrivé en premier. Le widget garde votre code dans le navigateur du visiteur pendant 72 heures : une personne qui revient le lendemain compte donc toujours. Après ce premier achat, le rattachement est définitif, et les achats suivants sur le même compte Atli comptent aussi pour vous.
Les prix sont les mêmes que dans la boutique Atli, et une éventuelle réduction liée à votre code s’affiche au paiement. Le guide du programme d’affiliation Atli détaille les gains et les versements.
FAQ
Le widget Atli est-il payant ?
Ai-je besoin de mon propre compte Stripe ?
Les visiteurs peuvent-ils installer l'eSIM depuis le widget ?
Puis-je limiter le widget aux pays que je couvre ?
data-destination l’ouvre sur une destination, et data-favorites remplit l’onglet Top avec jusqu’à 32 destinations de votre choix. Les visiteurs peuvent toujours chercher dans tout le catalogue.Le widget va-t-il ralentir ma page ?
Puis-je mettre deux widgets sur une même page ?
HeyAtli.init() une fois pour chaque conteneur.


