Demo live

Integrazione API eSIM

Integrazione API di Airalo: vendete eSIM con ogni viaggio

Collegate il vostro account partner Airalo a PHPTRAVELS e vendete eSIM locali, regionali e globali sul vostro sito, accanto a voli, hotel e tour. Il connettore è pronto: inserite Client ID e Client Secret, provate in sandbox, sincronizzate i pacchetti, impostate il prezzo e andate online.

  • Connettore Airalo pronto
  • Airalo Partner API v2
  • Codice QR e passaggi di installazione
  • Il vostro prezzo di vendita

Il fornitore

Che cos'è Airalo e perché le agenzie vendono le sue eSIM

Airalo vende eSIM: pacchetti SIM digitali che il viaggiatore installa sul telefono senza togliere la SIM fisica. Invece di comprare una SIM locale in aeroporto, il viaggiatore acquista i dati prima del viaggio e li installa in pochi minuti.

Con la Partner API di Airalo, un'azienda di viaggi può vendere questo inventario sul proprio sito o app. PHPTRAVELS include un connettore Airalo nel modulo eSIM, così la eSIM diventa un prodotto in più nello stesso carrello di volo, hotel, transfer, visto o tour.

Correlati:eSIMAPI di viaggioIntegrazione API di viaggio

Scheda del fornitore
Azienda
Airalo, fornitore di connettività eSIM
Copertura
Oltre 200 destinazioni, secondo Airalo
Pacchetti
eSIM locali, regionali e globali
API
Partner API v2 · REST · token Bearer
SDK
PHP · Node.js · Python
In PHPTRAVELS
Connettore pronto nel modulo eSIM

Passo 1 · Account partner

Richiedete un account partner Airalo

L'accesso all'API di Airalo richiede un accordo di partnership con Airalo. PHPTRAVELS non rilascia account né chiavi Airalo: voi fate richiesta, Airalo valuta la vostra azienda e vi invia le credenziali.

Cosa inviare ad Airalo

  • Nome dell'azienda e sito web
  • Paese e tipo di attività
  • Volume previsto di vendite eSIM
  • Mercati e destinazioni di riferimento
  • B2C, B2B o entrambi
  • Che utilizzate PHPTRAVELS

Passo 2 · Credenziali

Client ID, Client Secret e il token di accesso

Quando Airalo approva il vostro account ricevete un Client ID e un Client Secret. PHPTRAVELS li invia all'endpoint del token dal vostro server, riceve un token di accesso Bearer e lo usa per ogni richiesta di pacchetti, ordini ed eSIM.

Richiesta del token (esempio)
 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
Solo lato server
Il token viene richiesto dal vostro server PHPTRAVELS. Il Client Secret non arriva mai al browser.
Riutilizzo del token
Il connettore conserva il token fino alla scadenza, quindi non ne chiede uno nuovo a ogni ricerca.
Mantenete privato il secret
Non inserite mai il Client Secret in JavaScript pubblico, HTML, un repository Git pubblico, uno screenshot o un forum.
Un account, due modalità
Airalo vi permette di scegliere Sandbox o Production nella configurazione. Provate tutto prima in Sandbox.

Il flusso della Partner API

Cinque chiamate API Airalo dietro ogni vendita di eSIM

Dal primo prezzo a schermo al codice QR nella casella del viaggiatore, il connettore usa sempre le stesse cinque chiamate. Per ognuna vedete cosa fa PHPTRAVELS con la risposta.

  1. 01Ottenere un tokenPOST/v2/token

    PHPTRAVELSAccede con Client ID e Client Secret e salva il token Bearer sul server.

  2. 02Elencare i pacchettiGET/v2/packages

    PHPTRAVELSSincronizza pacchetti locali, regionali e globali con dati, validità, copertura e prezzo netto, poi applica il vostro prezzo.

  3. 03Inviare un ordinePOST/v2/orders

    PHPTRAVELSDopo il pagamento ordina l'ID pacchetto e la quantità scelti e salva l'ordine Airalo nella prenotazione.

  4. 04Leggere la eSIMGET/v2/sims/{sim_iccid}

    PHPTRAVELSLegge la eSIM tramite ICCID: codice QR, codice di attivazione, indirizzo SM-DP+ e link di installazione diretta su iOS.

  5. 05Passaggi di installazioneGET/v2/sims/{sim_iccid}/instructions

    PHPTRAVELSOttiene le istruzioni di installazione di Airalo per il dispositivo e la lingua del viaggiatore e le aggiunge al voucher.

Passi 3-5 · Pannello PHPTRAVELS

Configurate, provate e sincronizzate Airalo nel pannello

Tutto avviene nelle impostazioni del modulo eSIM del vostro pannello PHPTRAVELS. I campi esatti dipendono dalla vostra versione di PHPTRAVELS.

  1. 01Attivate il modulo eSIMAprite le impostazioni del modulo e attivate l'integrazione eSIM di Airalo.
  2. 02Inserite le credenzialiIncollate Client ID e Client Secret ricevuti da Airalo, scegliete Sandbox e salvate.
  3. 03Provate la connessioneUsate il pulsante di prova. PHPTRAVELS accede ad Airalo e mostra lo stato connesso oppure l'errore da correggere.
  4. 04Sincronizzate i pacchettiCaricate i pacchetti Airalo e verificate che destinazioni, dati, validità e prezzi appaiano corretti sul vostro sito.
Modulo eSIM · AiraloAiralo

Ambiente

Ordini di prova: nessuna eSIM reale viene attivataOrdini reali: eSIM reali, addebitate sul vostro saldo Airalo

Client ID7f3c…a91e
Client Secret••••••••••••••••
Ricarico15% sul prezzo netto
StatoConnesso

Schermata di esempio. I campi possono variare nella vostra versione.

Passo 5 · Pacchetti eSIM

eSIM locali, regionali e globali da un unico feed

Airalo restituisce tre tipi di pacchetti, così potete abbinare la eSIM all'itinerario del viaggiatore. Pacchetti, prezzi e disponibilità arrivano sempre in tempo reale da Airalo.

  • eSIM locale

    Una destinazione, per un viaggio in un solo paese.

    EsempioeSIM USA

  • eSIM regionale

    Più paesi di una regione, per un viaggio in più paesi.

    EsempioeSIM Europa

  • eSIM globale

    Paesi di più regioni, per viaggi lunghi o giri del mondo.

    EsempioeSIM globale

Mostrato al viaggiatore
Destinazione · nome del pacchetto · dati · validità · rete · copertura · prezzo
Tagli di dati tipici: 1 GB, 3 GB, 5 GB e 10 GB, ognuno con la propria validità.

Passi 6-9 · La vendita

Come un viaggiatore acquista una eSIM Airalo sul vostro sito

Il viaggiatore non lascia mai il vostro sito. PHPTRAVELS gestisce prenotazione e pagamento, Airalo attiva la eSIM.

  1. 01Viaggiatore

    Apre la sezione eSIM del vostro sito

  2. 02Viaggiatore

    Sceglie una destinazione

  3. 03PHPTRAVELS

    Mostra i pacchetti Airalo con il vostro prezzo

  4. 04Viaggiatore

    Sceglie un pacchetto

  5. 05Viaggiatore

    Prenota e paga con il vostro gateway di pagamento

  6. 06PHPTRAVELS

    Invia l'ordine all'API di Airalo

  7. 07Airalo

    Attiva la eSIM

  8. 08Airalo

    Restituisce il codice QR e i dati di installazione

  9. 09PHPTRAVELS

    Invia la eSIM al viaggiatore via email e nell'account

Consegna della eSIM

Cinque modi per installare la eSIM

Airalo supporta diversi flussi di installazione per i partner API. PHPTRAVELS inserisce i dati nel voucher di prenotazione, nell'email di conferma e nell'account del viaggiatore.

  • Codice QR

    Il viaggiatore scansiona il codice QR dalle impostazioni eSIM del telefono.

  • Inserimento manuale

    Il codice di attivazione e l'indirizzo SM-DP+, per i telefoni che non possono scansionare.

  • Istruzioni Airalo

    Istruzioni di installazione passo per passo dall'API, per dispositivo e lingua.

  • Link eSIM Cloud o PDF

    Un link di condivisione o un PDF di Airalo con la guida completa all'installazione.

  • Installazione diretta su iOS

    Un link di installazione con un tocco per iPhone compatibili con versioni di iOS supportate.

Dati del cliente

Associate ogni cliente a un ICCID

Airalo identifica ogni eSIM tramite il suo ICCID e, in questo flusso, non conserva i dati personali dei vostri viaggiatori. Mantenere il legame tra viaggiatore ed eSIM spetta a voi, e PHPTRAVELS lo fa nella prenotazione.

  1. Cliente
  2. Prenotazione PHPTRAVELS
  3. Ordine Airalo
  4. ICCID

Questa catena semplifica l'assistenza:Richieste di assistenzaProblemi di installazioneRicerca ordiniStorico prenotazioniStato della eSIM

Passo 7 · Il vostro prezzo

Impostate il prezzo di vendita e guadagnate su ogni eSIM

Airalo vi addebita il costo del pacchetto previsto dal vostro accordo commerciale. Siete voi a decidere quanto paga il viaggiatore, nei limiti dell'accordo con Airalo.

  • Ricarico fisso

    Lo stesso importo aggiunto a ogni pacchetto.

  • Ricarico percentuale

    Una percentuale del prezzo netto, così il margine cresce con i piani più grandi.

  • Commissione di servizio

    Una commissione separata per ordine, mostrata al checkout.

  • Inclusa in un pacchetto

    Una eSIM inclusa in un pacchetto vacanza o in omaggio con un volo.

Esempio di cross-selling
  1. Volo per Dubai
  2. Hotel a Dubai
  3. Transfer dall'aeroporto
  4. eSIM Emirati Arabi

Perché le agenzie aggiungono le eSIM

  • Più ricavi per prenotazione
  • Un servizio accessorio di cui quasi ogni viaggiatore internazionale ha bisogno
  • Consegna digitale immediata, senza magazzino
  • I viaggiatori tornano per il viaggio successivo

L'opzione voucher. Airalo vende anche voucher eSIM: acquistate codici di attivazione e li distribuite tramite sito, app, CRM o email. Scegliete il metodo previsto dal vostro accordo con Airalo.

Risoluzione dei problemi

Se qualcosa non funziona, controllate prima questi punti

La maggior parte dei problemi riguarda credenziali, ambiente o dispositivo. Seguite l'elenco relativo al problema che vedete.

La prova di connessione non riesce
Client IDClient Secretaccount partner attivoaccesso API abilitatoSandbox o ProductionHTTPS in uscita dal vostro serverSSL
Non compare nessun pacchetto eSIM
Connessione APIdisponibilità dei pacchettiambientefiltri di destinazionerisposta dell'APIcache di PHPTRAVELS
Un ordine non va a buon fine
Pacchetto non valido o non disponibilesaldo Airaloerrore del tokenerrore di reteambiente sbagliatoproblema temporaneo di Airalo
Il codice QR non compare
Ordine completatoeSIM attivataICCID salvatodati di installazione restituiticampi QR nella risposta dell'API
Il viaggiatore non riesce a installarla
Telefono compatibile con eSIMtelefono sbloccatoil codice QR giustoeSIM non già installataroaming attivoAPN dove necessario

Chi fa cosa

PHPTRAVELS gestisce il software, Airalo gestisce le eSIM

Airalo è un fornitore esterno. Il rapporto commerciale è tra la vostra azienda di viaggi e Airalo.

PHPTRAVELS

  • Il connettore Airalo e le sue impostazioni
  • Le pagine eSIM, la ricerca e il checkout
  • Il vostro ricarico e i gateway di pagamento
  • Voucher, email e ICCID nella prenotazione
  • L'assistenza sull'integrazione stessa

Airalo

  • Approvazione dei partner e credenziali API
  • Prezzi dei pacchetti, commissioni e regole sul saldo
  • Copertura, reti e disponibilità dei pacchetti
  • Disponibilità dell'API e attivazione delle eSIM
  • Il vostro accordo commerciale

Sicurezza

Proteggete le vostre credenziali Airalo

  • Autenticatevi solo dal server, mai in JavaScript nel browser
  • Usate HTTPS per il sito e il pannello
  • Proteggete il pannello di amministrazione e limitate l'accesso al server
  • Mantenete PHPTRAVELS aggiornato
  • Monitorate le attività API insolite
  • Airalo

Vi serve aiuto con l'integrazione?

Se il vostro account Airalo è approvato ma l'integrazione mostra un errore, aprite un ticket di assistenza nel vostro account PHPTRAVELS indicando: la versione di PHPTRAVELS, uno screenshot delle impostazioni Airalo, il risultato della prova, una destinazione e un pacchetto di esempio, il codice di prenotazione e il messaggio di errore. Non includete mai il Client Secret completo.

Apri un ticket di assistenzaVedi i prezziPrenota una demo

Leggete: come le agenzie di viaggio possono vendere eSIM onlineDocumentazione per sviluppatori Airalo

Domande frequenti

Integrazione API di Airalo: le domande delle agenzie

Contatta il team vendite

No. Vi serve un vostro account partner Airalo approvato. PHPTRAVELS fornisce il software e il connettore Airalo pronto.

Airalo invia Client ID e Client Secret dopo aver approvato il vostro account partner. PHPTRAVELS non li rilascia.

I clienti PHPTRAVELS possono scrivere a Rao Suhaib Khan, Head of Partnerships di Airalo, all'indirizzo rao.khan@airalo.com, indicando che usano PHPTRAVELS.

Sì. Con un account partner Airalo approvato e il connettore PHPTRAVELS, i pacchetti Airalo supportati compaiono sul vostro sito e la prenotazione resta sul vostro sito.

Sì, un ricarico fisso o percentuale oppure una commissione di servizio, purché rientri nel vostro accordo commerciale con Airalo.

Sì. Airalo ha una modalità Sandbox in cui gli ordini di prova non attivano eSIM reali. Passate a Production solo quando l'intero flusso funziona.

Sì. Airalo offre pacchetti locali, regionali e globali, in base all'inventario disponibile per ogni destinazione.

Con il codice QR, inserendo il codice di attivazione e l'indirizzo SM-DP+, con le istruzioni passo per passo di Airalo, da un link eSIM Cloud o un PDF, oppure con un link di installazione diretta sugli iPhone compatibili.

No. Airalo offre SDK per PHP, Node.js e Python, ma il connettore è già in PHPTRAVELS. Dovete solo aggiungere le vostre credenziali.

Continua a esplorare

Altro sulla piattaforma