Intégrer une API eSIM : le guide du développeur
Intégrer une API eSIM est l’une des fonctionnalités les plus rentables qu’un produit de voyage ou de télécom puisse livrer : quelques endpoints suffisent pour transformer votre tunnel de paiement en boutique de connectivité. Ce guide couvre toute l’intégration du point de vue du développeur : provisionnement, livraison, webhooks et les cas limites à traiter.
Le flux de base
Toute intégration de revendeur eSIM se résume à trois étapes :
1. Customer pays → your checkout
2. Provision the eSIM → POST /v1/esims
3. Deliver the QR code → confirmation page + email
Provisionnement
Quand le paiement aboutit, votre backend fait un seul appel :
curl -X POST https://api.esim.tech/v1/esims \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"product": "local-nl-unlimited",
"reference": "order_8412"
}'
La réponse revient immédiatement avec tout ce dont vous avez besoin :
{
"id": "esim_L4nX...",
"iccid": "8931089...",
"lpa": "LPA:1$smdp.esim.tech$K9MX-....",
"phone_number": "+31612345678",
"status": "ready",
"created_at": "2026-07-02T09:41:12Z"
}
Le code LPA figure dans la réponse elle-même : pas de polling, pas d’e-mail, pas de tâche asynchrone à attendre. Avec environ 120 ms de bout en bout, vous pouvez l’appeler de façon synchrone pendant le paiement. Pour les eSIM locales, le numéro de téléphone arrive dans la même réponse, et vous pouvez donc montrer au client son nouveau numéro local avant même qu’il ait scanné le QR code.
Livraison
Générez un QR code à partir de la chaîne LPA (n’importe quelle bibliothèque QR fait l’affaire, la chaîne est le contenu), puis :
- Affichez-le sur la page de confirmation
- Envoyez-le aussi par e-mail (les clients installent souvent plus tard, en Wi-Fi)
- Sur mobile, proposez en plus l’installation par lien universel, pour que les utilisateurs sur le même appareil n’aient pas besoin d’un second écran pour scanner
Webhooks de cycle de vie
Enregistrez un endpoint de webhook et vous recevrez des événements comme ceux-ci :
{ "type": "esim.activated", "esim": "esim_L4nX", "at": "..." }
{ "type": "usage.threshold", "esim": "esim_L4nX", "used_mb": 4096, "threshold": 0.8 }
{ "type": "balance.low", "esim": "esim_L4nX", "remaining_mb": 512 }
Servez-vous de l’événement balance.low pour déclencher un e-mail de recharge en un clic, qui arrive au moment où le client est le plus enclin à acheter. Les revendeurs qui automatisent cela constatent en général 20 à 30 % de chiffre d’affaires en plus par client.
Les choix de conception à ne pas rater
Idempotence. Passez votre identifiant de commande dans reference et relancez sans risque en cas d’erreur réseau. Vous ne provisionnerez (et ne paierez) jamais deux eSIM pour une seule commande.
Provisionnez au paiement, pas avant. Les eSIM sont facturées au provisionnement. Ne les générez pas à l’avance pour des paniers abandonnés.
Conservez l’ICCID. C’est l’identifiant stable dont vous aurez besoin pour le support, les recharges et les requêtes de consommation.
Répondez tôt à la question « mon téléphone est-il compatible ? ». Vérifiez la compatibilité eSIM de l’appareil dans votre interface avant le paiement plutôt que dans un e-mail de remboursement après coup.
Les types de produits que vous pouvez provisionner
Une seule intégration vous donne accès à tout le catalogue :
- Data en paiement à l’usage : facturation au Mo, recharges via l’API, plus de 190 pays
- eSIM locales : vrai numéro de téléphone local, voix, SMS et data (illimitée) dans plus de 25 pays
- Forfaits data UE : jusqu’à 500 Go pour routeurs, camping-cars et flottes dans toute l’UE
- Secours 5G : connectivité de bascule pour les sites fixes
Tous partagent la même structure d’API. Seul l’identifiant product change : élargir votre gamme plus tard se fait par configuration, sans nouveau projet. Si vous étudiez d’abord le côté business, commencez par comment devenir revendeur eSIM.
Passer en production
- Créez votre compte sur resellers.esim.tech
- Intégrez le provisionnement et l’affichage du QR code sur le sandbox
- Branchez l’endpoint de webhook (au minimum activation et solde bas)
- Testez tout le parcours d’installation sur un vrai iPhone et un vrai appareil Android
- Passez aux clés de production et lancez-vous
L’authentification se fait par jeton Bearer standard, l’API est du simple REST/JSON et il n’y a aucun volume minimum : votre première eSIM provisionnée peut aller à un vrai client.
Questions fréquentes
Qu'est-ce qu'un code LPA ?
Le code LPA (Local Profile Assistant) est la chaîne d'activation qu'un appareil compatible eSIM utilise pour télécharger son profil SIM. Il est généralement présenté sous forme de QR code. Format : LPA:1$smdp.example.com$ACTIVATION-CODE. Si votre API le renvoie instantanément, vous pouvez afficher le QR code directement dans votre tunnel de paiement.
À quelle vitesse se fait le provisionnement d'une eSIM via API ?
Chez eSIM.tech, un appel POST /v1/esims renvoie le code LPA et l'ICCID en 120 millisecondes environ de bout en bout, assez vite pour provisionner de façon synchrone pendant le paiement.
Faut-il des connaissances télécom particulières pour intégrer une API eSIM ?
Non. Si vous savez intégrer une API de paiement, vous savez intégrer une API eSIM. La complexité télécom (serveurs SM-DP+, accords avec les opérateurs, génération des profils) est cachée derrière l'interface REST.
Comment les clients installent-ils l'eSIM ?
Ils scannent le QR code que vous affichez (ou touchent un lien universel sur le même appareil). iOS et Android téléchargent et installent alors le profil. Un guide d'installation clair pour chaque plateforme réduit nettement les demandes au support.
