Intégration d'API eSIM
Intégration de l'API Airalo : vendez des eSIM avec chaque voyage
Connectez votre compte partenaire Airalo à PHPTRAVELS et vendez des eSIM locales, régionales et mondiales sur votre propre site, à côté des vols, hôtels et circuits. Le connecteur est prêt : ajoutez votre Client ID et votre Client Secret, testez en sandbox, synchronisez les forfaits, fixez votre prix et passez en production.
- Connecteur Airalo prêt
- Airalo Partner API v2
- Code QR et étapes d'installation
- Votre propre prix de vente
Le fournisseur
Ce qu'est Airalo, et pourquoi les agences vendent ses eSIM
Airalo vend des eSIM : des forfaits SIM numériques que le voyageur installe sur son téléphone sans retirer la carte SIM physique. Au lieu d'acheter une SIM locale à l'aéroport, le voyageur achète ses données avant le départ et les installe en quelques minutes.
Grâce à l'Airalo Partner API, une entreprise de voyage peut vendre cet inventaire sur son propre site ou dans son application. PHPTRAVELS intègre un connecteur Airalo dans le module eSIM : l'eSIM devient un produit de plus dans le même panier que le vol, l'hôtel, le transfert, le visa ou le circuit.
À voir aussi :eSIMAPI de voyageIntégration d'API de voyage
- Société
- Airalo, fournisseur de connectivité eSIM
- Couverture
- Plus de 200 destinations, selon Airalo
- Forfaits
- eSIM locales, régionales et mondiales
- API
- Partner API v2 · REST · jeton Bearer
- SDK
- PHP · Node.js · Python
- Dans PHPTRAVELS
- Connecteur prêt dans le module eSIM
Étape 1 · Compte partenaire
Demandez un compte partenaire Airalo
L'accès à l'API Airalo exige un accord de partenariat avec Airalo. PHPTRAVELS ne délivre ni comptes ni clés Airalo : vous faites la demande, Airalo examine votre entreprise et vous envoie vos identifiants.
Ce qu'il faut envoyer à Airalo
- Nom et site web de la société
- Pays et type d'activité
- Volume de ventes eSIM prévu
- Marchés et destinations ciblés
- B2C, B2B ou les deux
- Le fait que vous utilisez PHPTRAVELS
Étape 2 · Identifiants
Client ID, Client Secret et jeton d'accès
Lorsque Airalo approuve votre compte, vous recevez un Client ID et un Client Secret. PHPTRAVELS les envoie au point de terminaison du jeton depuis votre serveur, reçoit un jeton d'accès Bearer et l'utilise pour chaque requête de forfait, de commande et d'eSIM.
1# Server-side only: the Client Secret never reaches the browser 2curl -X POST "$AIRALO_API/v2/token" \ 3 -H "Accept: application/json" \ 4 -F "client_id=$CLIENT_ID" \ 5 -F "client_secret=$CLIENT_SECRET" \ 6 -F "grant_type=client_credentials" 7 8# → { "data": { "access_token": "eyJ0eXAi…", "expires_in": … } } 9# then: Authorization: Bearer <access_token>
- Uniquement côté serveur
- Le jeton est demandé par votre serveur PHPTRAVELS. Le Client Secret n'atteint jamais le navigateur.
- Réutilisation du jeton
- Le connecteur conserve le jeton jusqu'à son expiration. Il n'en redemande pas un à chaque recherche.
- Gardez le secret privé
- Ne placez jamais le Client Secret dans du JavaScript public, du HTML, un dépôt Git public, une capture d'écran ou un message de forum.
- Un compte, deux modes
- Airalo vous permet de choisir Sandbox ou Production dans sa configuration. Testez tout d'abord en Sandbox.
Le flux de la Partner API
Cinq appels à l'API Airalo derrière chaque vente d'eSIM
Du premier prix affiché jusqu'au code QR dans la boîte mail du voyageur, le connecteur utilise les cinq mêmes appels. Chacun indique ce que PHPTRAVELS fait de la réponse.
- 01Obtenir un jetonPOST/v2/token
PHPTRAVELSSe connecte avec votre Client ID et votre Client Secret, puis stocke le jeton Bearer sur le serveur.
- 02Lister les forfaitsGET/v2/packages
PHPTRAVELSSynchronise les forfaits locaux, régionaux et mondiaux avec données, validité, couverture et prix net, puis applique votre prix.
- 03Passer une commandePOST/v2/orders
PHPTRAVELSAprès le paiement, commande l'identifiant de forfait et la quantité choisis, puis enregistre la commande Airalo dans la réservation.
- 04Lire l'eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSLit l'eSIM par son ICCID : code QR, code d'activation, adresse SM-DP+ et lien d'installation directe sur iOS.
- 05Étapes d'installationGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSRécupère les instructions d'installation d'Airalo pour l'appareil et la langue du voyageur, et les ajoute au bon de voyage.
Étapes 3 à 5 · Administration PHPTRAVELS
Configurez, testez et synchronisez Airalo dans votre administration
Tout se passe dans les paramètres du module eSIM de votre administration PHPTRAVELS. Les champs exacts dépendent de votre version de PHPTRAVELS.
- 01Activez le module eSIMOuvrez les paramètres du module et activez l'intégration eSIM Airalo.
- 02Saisissez vos identifiantsCollez le Client ID et le Client Secret fournis par Airalo, choisissez Sandbox et enregistrez.
- 03Testez la connexionUtilisez le bouton Test. PHPTRAVELS se connecte à Airalo et affiche un statut connecté, ou l'erreur à corriger.
- 04Synchronisez les forfaitsChargez les forfaits Airalo et vérifiez que destinations, données, validité et prix s'affichent correctement sur votre site.
Environnement
Commandes de test : aucune eSIM réelle n'est fournieCommandes réelles : vraies eSIM, débitées de votre solde Airalo
Écran d'exemple. Les champs peuvent varier selon votre version.
Étape 5 · Forfaits eSIM
eSIM locales, régionales et mondiales dans un seul flux
Airalo propose trois types de forfaits pour adapter l'eSIM à l'itinéraire du voyageur. Les forfaits, les prix et la disponibilité proviennent toujours d'Airalo en temps réel.
eSIM locale
Une seule destination, pour un voyage dans un seul pays.
ExempleeSIM États-Unis
eSIM régionale
Plusieurs pays d'une même région, pour un voyage multi-pays.
ExempleeSIM Europe
eSIM mondiale
Des pays de plusieurs régions, pour les longs voyages ou les tours du monde.
ExempleeSIM mondiale
- Affiché au voyageur
- Destination · nom du forfait · données · validité · réseau · couverture · prix
- Volumes de données courants : 1 Go, 3 Go, 5 Go et 10 Go, chacun avec sa propre validité.
Étapes 6 à 9 · La vente
Comment un voyageur achète une eSIM Airalo sur votre site
Le voyageur ne quitte jamais votre site. PHPTRAVELS gère la réservation et le paiement, Airalo fournit l'eSIM.
- 01Voyageur
Ouvre la rubrique eSIM de votre site
- 02Voyageur
Choisit une destination
- 03PHPTRAVELS
Affiche les forfaits Airalo avec votre prix
- 04Voyageur
Choisit un forfait
- 05Voyageur
Réserve et paie via votre passerelle de paiement
- 06PHPTRAVELS
Envoie la commande à l'API Airalo
- 07Airalo
Fournit l'eSIM
- 08Airalo
Renvoie le code QR et les détails d'installation
- 09PHPTRAVELS
Envoie l'eSIM au voyageur par e-mail et dans son compte
Livraison de l'eSIM
Cinq façons d'installer l'eSIM pour le voyageur
Airalo prend en charge plusieurs méthodes d'installation pour ses partenaires API. PHPTRAVELS ajoute les détails au bon de réservation, à l'e-mail de confirmation et au compte du voyageur.
Code QR
Le voyageur scanne le code QR depuis les réglages eSIM de son téléphone.
Saisie manuelle
Le code d'activation et l'adresse SM-DP+, pour les téléphones qui ne peuvent pas scanner.
Instructions Airalo
Des instructions d'installation pas à pas fournies par l'API, selon l'appareil et la langue.
Lien eSIM Cloud ou PDF
Un lien de partage ou un PDF d'Airalo avec le guide d'installation complet.
Installation directe sur iOS
Un lien d'installation en un geste pour les iPhone compatibles sous une version d'iOS prise en charge.
Données client
Associez chaque client à un ICCID
Airalo identifie chaque eSIM par son ICCID et, pour ce flux, ne stocke pas les données personnelles de vos voyageurs. Conserver le lien entre le voyageur et l'eSIM vous revient, et PHPTRAVELS s'en charge dans la réservation.
- Client
- Réservation PHPTRAVELS
- Commande Airalo
- ICCID
Cette chaîne facilite le support :Demandes de supportProblèmes d'installationRecherche de commandeHistorique des réservationsStatut de l'eSIM
Étape 7 · Votre prix
Fixez votre prix de vente et gagnez sur chaque eSIM
Airalo vous facture le coût du forfait prévu dans votre accord commercial. Vous décidez du prix payé par le voyageur, dans le cadre de votre accord avec Airalo.
Marge fixe
Le même montant ajouté à chaque forfait.
Marge en pourcentage
Un pourcentage du prix net : la marge augmente avec les forfaits plus importants.
Frais de service
Des frais distincts par commande, affichés au paiement.
Inclus dans un forfait
Une eSIM incluse dans un séjour packagé ou offerte avec un vol.
- Vol pour Dubaï
- Hôtel à Dubaï
- Transfert aéroport
- eSIM Émirats arabes unis
Pourquoi les agences ajoutent des eSIM
- Plus de revenus par réservation
- Un service annexe utile à presque tous les voyageurs internationaux
- Livraison numérique instantanée, sans stock
- Les voyageurs reviennent pour leur prochain voyage
L'option bon d'achat. Airalo vend aussi des bons eSIM : vous achetez des codes d'activation et les distribuez via votre site, votre application, votre CRM ou par e-mail. Choisissez la méthode qui correspond à votre accord avec Airalo.
Dépannage
Si quelque chose ne fonctionne pas, vérifiez d'abord ces points
La plupart des problèmes viennent des identifiants, de l'environnement ou de l'appareil. Parcourez la liste correspondant au problème rencontré.
- Le test de connexion échoue
- Client IDClient Secretcompte partenaire actifaccès API activéSandbox ou ProductionHTTPS sortant depuis votre serveurSSL
- Aucun forfait eSIM ne s'affiche
- Connexion APIdisponibilité des forfaitsenvironnementfiltres de destinationréponse de l'APIcache PHPTRAVELS
- Une commande échoue
- Forfait invalide ou indisponiblesolde Airaloéchec du jetonerreur réseaumauvais environnementincident Airalo temporaire
- Le code QR ne s'affiche pas
- Commande finaliséeeSIM fournieICCID enregistrédonnées d'installation reçueschamps QR dans la réponse de l'API
- Le voyageur ne peut pas installer
- Téléphone compatible eSIMtéléphone désimlockébon code QReSIM pas déjà installéeitinérance activéeAPN si nécessaire
Qui fait quoi
PHPTRAVELS gère le logiciel, Airalo gère les eSIM
Airalo est un fournisseur externe. La relation commerciale lie votre entreprise de voyage et Airalo.
PHPTRAVELS
- Le connecteur Airalo et ses paramètres
- Les pages eSIM, la recherche et le paiement
- Votre marge et vos passerelles de paiement
- Bons, e-mails et ICCID dans la réservation
- Le support de l'intégration elle-même
Airalo
- Validation du partenaire et identifiants API
- Prix des forfaits, commissions et règles de solde
- Couverture, réseaux et disponibilité des forfaits
- Disponibilité de l'API et fourniture des eSIM
- Votre accord commercial
Sécurité
Protégez vos identifiants Airalo
- Authentifiez-vous uniquement depuis le serveur, jamais en JavaScript dans le navigateur
- Utilisez HTTPS pour votre site et votre administration
- Sécurisez le panneau d'administration et limitez l'accès au serveur
- Maintenez PHPTRAVELS à jour
- Surveillez toute activité inhabituelle sur l'API
Airalo
Besoin d'aide pour l'intégration ?
Si votre compte Airalo est approuvé mais que l'intégration affiche une erreur, ouvrez un ticket de support dans votre compte PHPTRAVELS avec : votre version de PHPTRAVELS, une capture des paramètres Airalo, le résultat du test, un exemple de destination et de forfait, la référence de réservation et le message d'erreur. N'incluez jamais le Client Secret complet.
À lire : comment les agences de voyage peuvent vendre des eSIM en ligneDocumentation développeur Airalo
Non. Vous avez besoin de votre propre compte partenaire Airalo approuvé. PHPTRAVELS fournit le logiciel et le connecteur Airalo prêt à l'emploi.
Airalo envoie le Client ID et le Client Secret après avoir approuvé votre compte partenaire. PHPTRAVELS ne les délivre pas.
Les clients PHPTRAVELS peuvent écrire à Rao Suhaib Khan, responsable des partenariats chez Airalo, à rao.khan@airalo.com, en précisant qu'ils utilisent PHPTRAVELS.
Oui. Avec un compte partenaire Airalo approuvé et le connecteur PHPTRAVELS, les forfaits Airalo pris en charge apparaissent sur votre site et la réservation reste chez vous.
Oui, une marge fixe ou en pourcentage, ou des frais de service, à condition de respecter votre accord commercial avec Airalo.
Oui. Airalo propose un mode Sandbox où les commandes de test ne fournissent pas de vraies eSIM. Passez en Production uniquement lorsque tout le flux fonctionne.
Oui. Airalo propose des forfaits locaux, régionaux et mondiaux, selon l'inventaire disponible pour chaque destination.
Avec le code QR, en saisissant le code d'activation et l'adresse SM-DP+, avec les instructions pas à pas d'Airalo, via un lien eSIM Cloud ou un PDF, ou avec un lien d'installation directe sur les iPhone compatibles.
Non. Airalo propose des SDK pour PHP, Node.js et Python, mais le connecteur est déjà intégré à PHPTRAVELS. Il vous suffit d'ajouter vos identifiants.
Continuez à explorer
Plus sur la plateforme
- eSIM
- Intégration API TiqetsBillets d'attractions Tiqets dans votre moteur de réservation
- Intégration de l'API ViatorVisites et activités Viator sur votre site de réservation
- Intégration PKFARE APIRecherche, réservation et PNR PKFARE dans votre portail
- Intégration de l'API RateHawkLes hôtels RateHawk dans votre moteur de réservation, connecteur prêt
- API de voyageAPI GDS, hôtels, tours, voitures et paiements