eSIMfly MCP

API eSIM pour les développeurs : vendez des eSIM dans votre propre produit

Intégrez des forfaits de données eSIM en gros pour 200 pays dans votre application, plateforme ou boutique via une seule API REST — catalogue, commandes, recharges, utilisation et gestion complète du cycle de vie.

Qui développe sur l'API eSIM

Les entreprises utilisent l'intégration eSIM en gros pour ajouter une source de revenus de connectivité à leur produit existant.

Applications de voyage et OTA

Proposez une vente additionnelle d'eSIM au moment de la réservation. Vos voyageurs atterrissent connectés, et vous conservez la marge sur chaque forfait vendu.

Revendeurs et MVNO

Approvisionnez-vous en eSIM à des tarifs de gros et vendez via vos propres canaux, avec vos propres prix et offres groupées.

Plateformes IoT et de flottes

Provisionnez et surveillez la connectivité des appareils et véhicules à l'international depuis une seule intégration.

Superapps et fintech

Ajoutez des forfaits de données internationaux comme fonctionnalité native aux côtés de vos produits de paiement, bancaires ou de fidélité.

CAPACITÉS DE L'API

Tout ce qu'il vous faut pour gérer des eSIM par programmation

L'API couvre l'ensemble du parcours, de la navigation dans les forfaits en gros à la gestion des eSIM actives sur le terrain.

Catalogue et tarification

Parcourez tous les forfaits de données disponibles avec les tarifs de gros pour 200 pays, et vérifiez le solde de votre compte avant de commander.

Obtenir tous les forfaitsConsultation du solde

Commandes et recharges

Provisionnez instantanément de nouvelles eSIM et rechargez celles qui existent déjà. Les commandes renvoient des QR codes et des détails d'activation prêts à être livrés à vos utilisateurs.

Créer une commandeForfaits de recharge et commandes

Cycle de vie des eSIM

Gérez chaque eSIM que vous avez émise : vérifiez le statut et l'utilisation des données, suspendez ou annulez des lignes, consultez les événements réseau et envoyez des SMS.

Lister / interroger les eSIMStatut de l'eSIMAnnuler / Suspendre / ActiverRapport d'utilisationÉvénements réseauEnvoyer un SMS

Webhooks

Enregistrez des points de terminaison pour recevoir des notifications en temps réel des événements de commande et du cycle de vie des eSIM — sans interrogation répétée.

Gestion des webhooksNotifications d'événements

Tarifs eSIM en gros, votre marge

Les partenaires API achètent des forfaits de données à des tarifs de gros et fixent leurs propres prix de détail. Le catalogue couvre des forfaits locaux, régionaux et mondiaux dans 200 pays et plus de 450 réseaux, de sorte qu'une seule intégration couvre chaque destination où vos utilisateurs voyagent. La facturation basée sur le solde simplifie le règlement : alimentez votre compte, et chaque commande y est débitée à votre tarif de gros.

Si vous préférez une vitrine complète plutôt que de développer la vôtre, notre plateforme de revendeur eSIM en marque blanche fournit un site web, un tableau de bord et des applications mobiles sous votre marque, sur la même infrastructure.

Sécurisé dès la conception : requêtes signées HMAC

Chaque appel API est authentifié par une signature HMAC-SHA256 portant sur l'horodatage de la requête, un identifiant de requête unique, votre code d'accès et le corps de la requête — assurant la vérification de l'intégrité et la protection contre les attaques par rejeu. Des exemples de signature prêts à l'emploi pour Node.js, Python et PHP sont disponibles dans la documentation.

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

Obtenez l'accès à l'API en trois étapes

1. Créez un compte professionnel

Inscrivez-vous à un compte professionnel eSIMfly et parlez-nous de votre cas d'usage et du volume attendu.

2. Générez vos clés API

Créez et gérez vos identifiants d'accès depuis le tableau de bord professionnel, puis alimentez votre solde.

3. Intégrez et lancez

Suivez la documentation pour parcourir les forfaits, passer une commande de test et, si vous le souhaitez, enregistrer un webhook pour les eSIM provisionnées de manière asynchrone.

FAQ

Questions sur l'API eSIM, avec réponses

Qu'est-ce que l'API eSIM d'eSIMfly ?+

L'API eSIMfly est une API REST qui vous permet d'acheter, de provisionner et de gérer des eSIM par programmation à des tarifs de gros. Vous pouvez parcourir le catalogue de forfaits, créer des commandes, recharger des forfaits, surveiller l'utilisation et gérer l'ensemble du cycle de vie des eSIM (activer, suspendre, annuler) depuis votre propre application, avec une couverture dans 200 pays et plus de 450 réseaux.

À qui s'adresse l'API eSIM ?+

L'API est conçue pour les entreprises qui souhaitent intégrer la connectivité eSIM dans leur propre produit : applications de voyage et plateformes de réservation, revendeurs télécom et MVNO, plateformes IoT et de flottes, et tout service qui souhaite offrir des données internationales à ses utilisateurs sans établir de relations avec les opérateurs.

Comment fonctionne l'authentification de l'API ?+

Les requêtes sont authentifiées par des signatures HMAC-SHA256. Chaque requête comporte un code d'accès, un identifiant de requête unique, un horodatage et une signature calculée avec votre clé secrète, ce qui assure la vérification de l'intégrité de la requête et empêche les attaques par rejeu. Des exemples de code pour Node.js, Python et PHP sont disponibles dans la documentation.

Comment obtenir l'accès à l'API eSIM ?+

Créez un compte professionnel eSIMfly, puis générez des clés API depuis le tableau de bord professionnel. Les paliers de tarification de gros dépendent du volume — contactez notre équipe commerciale pour discuter des tarifs correspondant à votre volume de commandes attendu.

L'API prend-elle en charge les webhooks ?+

Oui. Les webhooks vous notifient lorsque des eSIM provisionnées de manière asynchrone sont prêtes — certains opérateurs (comme KDDI Japon) prennent quelques minutes, et au lieu d'interroger en boucle, vous recevez un POST signé avec les détails de l'eSIM. La plupart des fournisseurs provisionnent de manière synchrone dans la réponse à la commande, et le statut et l'utilisation sont interrogés via les points de terminaison de statut et d'utilisation.

Quelles sont les limites de débit de l'API ?+

L'API autorise 1 000 requêtes par heure et par compte. Les requêtes datant de plus de 5 minutes sont rejetées dans le cadre de la protection contre les attaques par rejeu. Si vous avez besoin de limites plus élevées pour votre intégration, contactez le service commercial.

SDK OFFICIEL · NODE.JS / TYPESCRIPT

Évitez le code de signature — installez le SDK

npm install @esimfly/sdk vous offre un accès typé à toute l'API — la signature HMAC, la génération d'identifiants de requête frais, les commandes idempotentes, la synchronisation du catalogue à débit maîtrisé et la vérification des signatures de webhook sont intégrées. Zéro dépendance, Node.js 18+, sous licence MIT et open source. Les SDK PHP et Python arrivent ensuite.

Vous utilisez un agent IA ? Ajoutez le serveur MCP hébergé https://mcp.esimfly.net/mcp à Claude, ChatGPT ou Cursor et connectez-vous avec votre compte professionnel — aucune clé à coller. Recherchez des forfaits, vérifiez l'utilisation et diagnostiquez des eSIM sur l'API en direct ; en lecture seule par défaut, avec une étape de confirmation avant toute commande. Vous préférez le local ? npx -y @esimfly/mcp.

Tutoriels d'intégration

Du code Node.js fonctionnel, de la première requête aux webhooks en production.

[

COMMENCEZ ICI · GUIDE D'ARCHITECTURE

Guide d'intégration de l'API eSIM

Les quatre briques de base, l'authentification signée, le provisionnement synchrone vs par webhook, une liste d'évaluation des fournisseurs, et les pièges qui n'apparaissent qu'en production.

Lire le guide](https://esimfly.net/esim-api/integration-guide)

[

PARTIE 1 · ~30 MIN

Vendez des eSIM dans votre application avec Node.js

Authentification HMAC, catalogue de forfaits, création de commandes et livraison des QR codes — une vitrine complète et fonctionnelle.

Commencer le tutoriel](https://esimfly.net/esim-api/tutorials/sell-esims-nodejs)[

PARTIE 2 · CYCLE DE VIE

Recharges, suivi de l'utilisation et webhooks

Interrogations d'utilisation en direct, ventes de recharges sur des eSIM existantes, et webhooks signés sans interrogation répétée.

Passer à la deuxième partie](https://esimfly.net/esim-api/tutorials/topups-usage-webhooks)

Prêt à intégrer les eSIM dans votre produit ?

Commencez par la documentation, ou parlez à notre équipe des tarifs de gros pour votre volume.