Live demo

eSIM API-integratie

Airalo API-integratie: verkoop eSIMs bij elke reis

Koppel uw Airalo-partneraccount aan PHPTRAVELS en verkoop lokale, regionale en wereldwijde eSIMs op uw eigen website, naast vluchten, hotels en tours. De connector is klaar: voeg uw Client ID en Client Secret toe, test in de sandbox, synchroniseer de pakketten, stel uw prijs in en ga live.

  • Kant-en-klare Airalo-connector
  • Airalo Partner API v2
  • QR-code en installatiestappen
  • Uw eigen verkoopprijs

De leverancier

Wat Airalo is en waarom reisbureaus de eSIMs verkopen

Airalo verkoopt eSIMs: digitale simpakketten die een reiziger op de telefoon installeert zonder de fysieke simkaart te verwijderen. In plaats van op het vliegveld een lokale simkaart te kopen, koopt de reiziger vóór vertrek data en installeert die in een paar minuten.

Via de Airalo Partner API kan een reisbedrijf dit aanbod verkopen op de eigen website of in de eigen app. PHPTRAVELS levert een Airalo-connector in de eSIM-module. Zo wordt een eSIM gewoon een extra product in dezelfde winkelwagen als de vlucht, het hotel, de transfer, het visum of de tour.

Gerelateerd:eSIMReis-API'sReis-API-integratie

Leveranciersprofiel
Bedrijf
Airalo, aanbieder van eSIM-connectiviteit
Dekking
200+ bestemmingen, volgens Airalo
Pakketten
Lokale, regionale en wereldwijde eSIMs
API
Partner API v2 · REST · Bearer-token
SDKs
PHP · Node.js · Python
In PHPTRAVELS
Kant-en-klare connector in de eSIM-module

Stap 1 · Partneraccount

Vraag een Airalo-partneraccount aan

Voor toegang tot de Airalo API hebt u een partnerovereenkomst met Airalo nodig. PHPTRAVELS geeft geen Airalo-accounts of sleutels uit: u dient een aanvraag in, Airalo beoordeelt uw bedrijf en stuurt u de inloggegevens.

Wat u naar Airalo stuurt

  • Bedrijfsnaam en website
  • Land en type bedrijf
  • Verwacht verkoopvolume van eSIMs
  • Doelmarkten en bestemmingen
  • B2C, B2B of beide
  • Dat u PHPTRAVELS gebruikt

Stap 2 · Inloggegevens

Client ID, Client Secret en het access token

Zodra Airalo uw account goedkeurt, ontvangt u een Client ID en een Client Secret. PHPTRAVELS stuurt ze vanaf uw server naar het token-endpoint, ontvangt een Bearer access token en gebruikt dat voor elk verzoek voor pakketten, bestellingen en eSIMs.

Tokenverzoek (voorbeeld)
 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>
client_credentialsPartner API v2Bearer token · Sandbox → Production
Alleen op de server
Het token wordt aangevraagd door uw PHPTRAVELS-server. Het Client Secret komt nooit in de browser.
Token hergebruiken
De connector bewaart het token tot het verloopt. Zo vraagt hij niet bij elke zoekopdracht een nieuw token aan.
Houd het secret geheim
Zet het Client Secret nooit in openbare JavaScript, HTML, een openbare Git-repository, een screenshot of een forumbericht.
Eén account, twee modi
In de configuratie van Airalo kiest u Sandbox of Production. Test alles eerst in de Sandbox.

De Partner API-flow

Vijf Airalo API-aanroepen achter elke eSIM-verkoop

Van de eerste prijs op het scherm tot de QR-code in de inbox van de reiziger gebruikt de connector dezelfde vijf aanroepen. Bij elke aanroep ziet u wat PHPTRAVELS met het antwoord doet.

  1. 01Token ophalenPOST/v2/token

    PHPTRAVELSMeldt zich aan met uw Client ID en Client Secret en bewaart het Bearer-token op de server.

  2. 02Pakketten opvragenGET/v2/packages

    PHPTRAVELSSynchroniseert lokale, regionale en wereldwijde pakketten met data, geldigheid, dekking en nettoprijs en past daarna uw prijs toe.

  3. 03Bestelling plaatsenPOST/v2/orders

    PHPTRAVELSBestelt na betaling het gekozen pakket-ID en aantal en slaat de Airalo-bestelling op bij de boeking.

  4. 04eSIM uitlezenGET/v2/sims/{sim_iccid}

    PHPTRAVELSLeest de eSIM uit via de ICCID: QR-code, activatiecode, SM-DP+ adres en de directe iOS-installatielink.

  5. 05InstallatiestappenGET/v2/sims/{sim_iccid}/instructions

    PHPTRAVELSHaalt de installatie-instructies van Airalo op voor het toestel en de taal van de reiziger en voegt ze toe aan de voucher.

Stap 3 tot 5 · PHPTRAVELS-beheer

Airalo instellen, testen en synchroniseren in uw beheer

Alles gebeurt in de instellingen van de eSIM-module in uw PHPTRAVELS-beheer. De precieze velden hangen af van uw PHPTRAVELS-versie.

  1. 01Schakel de eSIM-module inOpen de module-instellingen en zet de Airalo eSIM-integratie aan.
  2. 02Voer uw inloggegevens inPlak de Client ID en het Client Secret van Airalo, kies Sandbox en sla op.
  3. 03Test de verbindingGebruik de testknop. PHPTRAVELS meldt zich aan bij Airalo en toont de status Verbonden, of de fout die u moet oplossen.
  4. 04Synchroniseer de pakkettenLaad de Airalo-pakketten en controleer of bestemmingen, data, geldigheid en prijzen kloppen op uw website.
eSIM-module · AiraloAiralo

Omgeving

Testbestellingen: er wordt geen echte eSIM geleverdLive bestellingen: echte eSIMs, afgeschreven van uw Airalo-saldo

Client ID7f3c…a91e
Client Secret••••••••••••••••
Marge15% op de nettoprijs
StatusVerbonden

Voorbeeldscherm. De velden kunnen in uw versie afwijken.

Stap 5 · eSIM-pakketten

Lokale, regionale en wereldwijde eSIMs uit één feed

Airalo levert drie soorten pakketten, zodat u de eSIM afstemt op de reisroute. Pakketten, prijzen en beschikbaarheid komen altijd live van Airalo.

  • Lokale eSIM

    Eén bestemming, voor een reis naar één land.

    VoorbeeldUSA eSIM

  • Regionale eSIM

    Meerdere landen in één regio, voor een reis langs meerdere landen.

    VoorbeeldEuropa eSIM

  • Wereldwijde eSIM

    Landen in meerdere regio's, voor lange reizen of wereldreizen.

    VoorbeeldGlobal eSIM

Zichtbaar voor de reiziger
Bestemming · pakketnaam · data · geldigheid · netwerk · dekking · prijs
Gangbare databundels: 1 GB, 3 GB, 5 GB en 10 GB, elk met een eigen geldigheid.

Stap 6 tot 9 · De verkoop

Zo koopt een reiziger een Airalo eSIM op uw website

De reiziger verlaat uw website nooit. PHPTRAVELS regelt de boeking en betaling, Airalo levert de eSIM.

  1. 01Reiziger

    Opent het eSIM-gedeelte van uw website

  2. 02Reiziger

    Kiest een bestemming

  3. 03PHPTRAVELS

    Toont de Airalo-pakketten met uw prijs

  4. 04Reiziger

    Kiest een pakket

  5. 05Reiziger

    Boekt en betaalt via uw betaalprovider

  6. 06PHPTRAVELS

    Stuurt de bestelling naar de Airalo API

  7. 07Airalo

    Levert de eSIM

  8. 08Airalo

    Stuurt de QR-code en installatiegegevens terug

  9. 09PHPTRAVELS

    Stuurt de reiziger de eSIM per e-mail en in het account

eSIM-levering

Vijf manieren waarop de reiziger de eSIM installeert

Airalo ondersteunt meerdere installatiemethoden voor API-partners. PHPTRAVELS zet de gegevens op de boekingsvoucher, in de bevestigingsmail en in het account van de reiziger.

  • QR-code

    De reiziger scant de QR-code vanuit de eSIM-instellingen van de telefoon.

  • Handmatig invoeren

    De activatiecode en het SM-DP+ adres, voor telefoons die niet kunnen scannen.

  • Instructies van Airalo

    Stapsgewijze installatie-instructies uit de API, per toestel en taal.

  • eSIM Cloud-link of pdf

    Een deellink of pdf van Airalo met de volledige installatiehandleiding.

  • Directe iOS-installatie

    Een installatielink met één tik voor compatibele iPhones met ondersteunde iOS-versies.

Klantgegevens

Koppel elke klant aan een ICCID

Airalo herkent elke eSIM aan de ICCID en slaat bij deze werkwijze geen persoonsgegevens van uw reizigers op. De koppeling tussen reiziger en eSIM bewaart u zelf, en PHPTRAVELS doet dat bij de boeking.

  1. Klant
  2. PHPTRAVELS-boeking
  3. Airalo-bestelling
  4. ICCID

Deze keten maakt support eenvoudig:SupportvragenInstallatieproblemenBestelling opzoekenBoekingsgeschiedeniseSIM-status

Stap 7 · Uw prijs

Stel uw verkoopprijs in en verdien aan elke eSIM

Airalo rekent u de pakketprijs uit uw commerciële overeenkomst. U bepaalt wat de reiziger betaalt, binnen uw overeenkomst met Airalo.

  • Vaste marge

    Hetzelfde bedrag bovenop elk pakket.

  • Procentuele marge

    Een percentage van de nettoprijs, zodat uw marge meegroeit met grotere bundels.

  • Servicekosten

    Aparte kosten per bestelling, getoond bij het afrekenen.

  • Inbegrepen in een pakket

    Een eSIM als onderdeel van een vakantiepakket of als cadeau bij een vlucht.

Voorbeeld van cross-selling
  1. Vlucht naar Dubai
  2. Hotel in Dubai
  3. Luchthaventransfer
  4. VAE eSIM

Waarom reisbureaus eSIMs toevoegen

  • Meer omzet per boeking
  • Een extra dienst die bijna elke internationale reiziger nodig heeft
  • Directe digitale levering, geen voorraad
  • Reizigers komen terug voor de volgende reis

De voucheroptie. Airalo verkoopt ook eSIM-vouchers: u koopt activatiecodes en deelt ze uit via uw website, app, CRM of e-mail. Kies de methode die past bij uw overeenkomst met Airalo.

Problemen oplossen

Werkt er iets niet? Controleer eerst deze punten

De meeste problemen liggen bij de inloggegevens, de omgeving of het toestel. Loop de lijst af voor het probleem dat u ziet.

De verbindingstest mislukt
Client IDClient Secretpartneraccount actiefAPI-toegang ingeschakeldSandbox of Productionuitgaand HTTPS vanaf uw serverSSL
Er verschijnen geen eSIM-pakketten
API-verbindingbeschikbaarheid van pakkettenomgevingbestemmingsfiltershet API-antwoordPHPTRAVELS-cache
Een bestelling mislukt
Ongeldig of niet beschikbaar pakketAiralo-saldotokenfoutnetwerkfoutverkeerde omgevingtijdelijk probleem bij Airalo
De QR-code verschijnt niet
Bestelling voltooideSIM geleverdICCID opgeslageninstallatiegegevens ontvangenQR-velden in het API-antwoord
De reiziger kan niet installeren
Telefoon ondersteunt eSIMtelefoon is simlockvrijde juiste QR-codeeSIM nog niet geïnstalleerdroaming aanAPN waar nodig

Wie doet wat

PHPTRAVELS levert de software, Airalo de eSIMs

Airalo is een externe leverancier. De commerciële relatie loopt tussen uw reisbedrijf en Airalo.

PHPTRAVELS

  • De Airalo-connector en de instellingen
  • De eSIM-pagina's, zoekfunctie en checkout
  • Uw marge en betaalproviders
  • Vouchers, e-mails en de ICCID bij de boeking
  • Support voor de integratie zelf

Airalo

  • Partnergoedkeuring en API-inloggegevens
  • Pakketprijzen, commissies en saldoregels
  • Dekking, netwerken en beschikbaarheid van pakketten
  • Beschikbaarheid van de API en levering van eSIMs
  • Uw commerciële overeenkomst

Beveiliging

Bescherm uw Airalo-inloggegevens

  • Authenticeer alleen vanaf de server, nooit in JavaScript in de browser
  • Gebruik HTTPS voor uw website en beheer
  • Beveilig het beheerpaneel en beperk de toegang tot de server
  • Houd PHPTRAVELS up-to-date
  • Let op ongebruikelijke API-activiteit
  • Airalo

Hulp nodig bij de integratie?

Is uw Airalo-account goedgekeurd maar toont de integratie een fout? Open dan een supportticket in uw PHPTRAVELS-account met: uw PHPTRAVELS-versie, een screenshot van de Airalo-instellingen, het testresultaat, een voorbeeld van bestemming en pakket, het boekingsnummer en de foutmelding. Stuur nooit het volledige Client Secret mee.

Open een supportticketBekijk prijzenPlan een demo

Lees: zo verkopen reisbureaus eSIMs onlineOntwikkelaarsdocumentatie van Airalo

FAQ

Airalo API-integratie: vragen van reisbureaus

Praat met sales

Nee. U hebt een eigen, goedgekeurd Airalo-partneraccount nodig. PHPTRAVELS levert de software en de kant-en-klare Airalo-connector.

Airalo stuurt de Client ID en het Client Secret nadat het uw partneraccount heeft goedgekeurd. PHPTRAVELS geeft ze niet uit.

PHPTRAVELS-klanten kunnen Rao Suhaib Khan, Head of Partnerships bij Airalo, mailen via rao.khan@airalo.com en vermelden dat ze PHPTRAVELS gebruiken.

Ja. Met een goedgekeurd Airalo-partneraccount en de PHPTRAVELS-connector verschijnen ondersteunde Airalo-pakketten op uw eigen website en blijft de boeking op uw site.

Ja, een vaste of procentuele marge of servicekosten, zolang dat past binnen uw commerciële overeenkomst met Airalo.

Ja. Airalo heeft een Sandbox-modus waarin testbestellingen geen echte eSIMs leveren. Schakel pas over naar Production als de volledige flow werkt.

Ja. Airalo biedt lokale, regionale en wereldwijde pakketten, afhankelijk van het aanbod per bestemming.

Met de QR-code, door de activatiecode en het SM-DP+ adres in te voeren, met de stapsgewijze instructies van Airalo, via een eSIM Cloud-link of pdf, of met een directe installatielink op compatibele iPhones.

Nee. Airalo heeft SDKs voor PHP, Node.js en Python, maar de connector zit al in PHPTRAVELS. U voegt alleen uw inloggegevens toe.

Verder ontdekken

Meer over het platform