Integracja eSIM API
Integracja Airalo API: sprzedawaj eSIM do każdej podróży
Połącz swoje konto partnera Airalo z PHPTRAVELS i sprzedawaj lokalne, regionalne i globalne eSIM na własnej stronie, obok lotów, hoteli i wycieczek. Konektor jest gotowy: dodaj Client ID i Client Secret, przetestuj w sandboksie, zsynchronizuj pakiety, ustaw cenę i uruchom sprzedaż.
- Gotowy konektor Airalo
- Airalo Partner API v2
- Kod QR i kroki instalacji
- Twoja własna cena sprzedaży
Dostawca
Czym jest Airalo i dlaczego biura podróży sprzedają jego eSIM
Airalo sprzedaje eSIM: cyfrowe pakiety SIM, które podróżny instaluje w telefonie bez wyjmowania fizycznej karty SIM. Zamiast kupować lokalną kartę SIM na lotnisku, podróżny kupuje pakiet danych przed wyjazdem i instaluje go w kilka minut.
Dzięki Airalo Partner API firma turystyczna może sprzedawać tę ofertę na własnej stronie lub w aplikacji. PHPTRAVELS dostarcza konektor Airalo w module eSIM. Dzięki temu eSIM staje się kolejnym produktem w tym samym koszyku co lot, hotel, transfer, wiza czy wycieczka.
- Firma
- Airalo, dostawca łączności eSIM
- Zasięg
- Ponad 200 kierunków, według Airalo
- Pakiety
- Lokalne, regionalne i globalne eSIM
- API
- Partner API v2 · REST · token Bearer
- SDK
- PHP · Node.js · Python
- W PHPTRAVELS
- Gotowy konektor w module eSIM
Krok 1 · Konto partnera
Złóż wniosek o konto partnera Airalo
Dostęp do Airalo API wymaga umowy partnerskiej z Airalo. PHPTRAVELS nie wydaje kont ani kluczy Airalo: Ty składasz wniosek, Airalo weryfikuje Twoją firmę i przesyła dane dostępowe.
Co wysłać do Airalo
- Nazwa firmy i strona internetowa
- Kraj i rodzaj działalności
- Przewidywana sprzedaż eSIM
- Rynki docelowe i kierunki
- B2C, B2B lub oba
- Informację, że korzystasz z PHPTRAVELS
Krok 2 · Dane dostępowe
Client ID, Client Secret i token dostępu
Po zatwierdzeniu konta przez Airalo otrzymujesz Client ID i Client Secret. PHPTRAVELS wysyła je z Twojego serwera do endpointu tokena, otrzymuje token dostępu Bearer i używa go przy każdym zapytaniu o pakiety, zamówienia i 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>
- Tylko po stronie serwera
- Token pobiera Twój serwer PHPTRAVELS. Client Secret nigdy nie trafia do przeglądarki.
- Ponowne użycie tokena
- Konektor przechowuje token do jego wygaśnięcia, więc nie pobiera nowego przy każdym wyszukiwaniu.
- Chroń sekret
- Nigdy nie umieszczaj Client Secret w publicznym JavaScript, HTML, publicznym repozytorium Git, na zrzucie ekranu ani w poście na forum.
- Jedno konto, dwa tryby
- W konfiguracji Airalo wybierasz Sandbox lub Production. Najpierw przetestuj wszystko w Sandbox.
Przepływ Partner API
Pięć wywołań Airalo API za każdą sprzedażą eSIM
Od pierwszej ceny na ekranie po kod QR w skrzynce podróżnego konektor używa tych samych pięciu wywołań. Przy każdym widać, co PHPTRAVELS robi z odpowiedzią.
- 01Pobranie tokenaPOST/v2/token
PHPTRAVELSLoguje się za pomocą Client ID i Client Secret i zapisuje token Bearer na serwerze.
- 02Lista pakietówGET/v2/packages
PHPTRAVELSSynchronizuje pakiety lokalne, regionalne i globalne z ilością danych, ważnością, zasięgiem i ceną netto, a potem nalicza Twoją cenę.
- 03Złożenie zamówieniaPOST/v2/orders
PHPTRAVELSPo płatności zamawia wybrany identyfikator pakietu i ilość, a zamówienie Airalo zapisuje w rezerwacji.
- 04Odczyt eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSOdczytuje eSIM po numerze ICCID: kod QR, kod aktywacyjny, adres SM-DP+ i bezpośredni link instalacji na iOS.
- 05Kroki instalacjiGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSPobiera instrukcję instalacji Airalo dla urządzenia i języka podróżnego i dodaje ją do vouchera.
Kroki 3 do 5 · Panel PHPTRAVELS
Skonfiguruj, przetestuj i zsynchronizuj Airalo w panelu
Wszystko odbywa się w ustawieniach modułu eSIM w panelu administracyjnym PHPTRAVELS. Dokładne pola zależą od Twojej wersji PHPTRAVELS.
- 01Włącz moduł eSIMOtwórz ustawienia modułu i włącz integrację Airalo eSIM.
- 02Wpisz dane dostępoweWklej Client ID i Client Secret od Airalo, wybierz Sandbox i zapisz.
- 03Przetestuj połączenieUżyj przycisku Test. PHPTRAVELS loguje się do Airalo i pokazuje status Połączono albo błąd do poprawienia.
- 04Zsynchronizuj pakietyWczytaj pakiety Airalo i sprawdź, czy kierunki, dane, ważność i ceny wyglądają poprawnie na Twojej stronie.
Środowisko
Zamówienia testowe: nie jest wydawana prawdziwa eSIMZamówienia na żywo: prawdziwe eSIM, opłacane z salda Airalo
Przykładowy ekran. Pola mogą się różnić w Twojej wersji.
Krok 5 · Pakiety eSIM
Lokalne, regionalne i globalne eSIM z jednego źródła
Airalo zwraca trzy rodzaje pakietów, więc możesz dopasować eSIM do trasy podróżnego. Pakiety, ceny i dostępność zawsze pochodzą na żywo z Airalo.
Lokalna eSIM
Jeden kierunek, na podróż do jednego kraju.
PrzykładeSIM USA
Regionalna eSIM
Kilka krajów w jednym regionie, na podróż po kilku krajach.
PrzykładeSIM Europa
Globalna eSIM
Kraje w kilku regionach, na długie podróże lub podróże dookoła świata.
PrzykładGlobalna eSIM
- Widoczne dla podróżnego
- Kierunek · nazwa pakietu · dane · ważność · sieć · zasięg · cena
- Typowe pakiety danych: 1 GB, 3 GB, 5 GB i 10 GB, każdy z własnym okresem ważności.
Kroki 6 do 9 · Sprzedaż
Jak podróżny kupuje eSIM Airalo na Twojej stronie
Podróżny nie opuszcza Twojej strony. PHPTRAVELS obsługuje rezerwację i płatność, Airalo wydaje eSIM.
- 01Podróżny
Otwiera sekcję eSIM na Twojej stronie
- 02Podróżny
Wybiera kierunek
- 03PHPTRAVELS
Pokazuje pakiety Airalo z Twoją ceną
- 04Podróżny
Wybiera pakiet
- 05Podróżny
Rezerwuje i płaci przez Twoją bramkę płatniczą
- 06PHPTRAVELS
Wysyła zamówienie do Airalo API
- 07Airalo
Wydaje eSIM
- 08Airalo
Zwraca kod QR i dane instalacji
- 09PHPTRAVELS
Przesyła podróżnemu eSIM e-mailem i na konto
Dostarczenie eSIM
Pięć sposobów instalacji eSIM przez podróżnego
Airalo obsługuje kilka sposobów instalacji dla partnerów API. PHPTRAVELS umieszcza dane na voucherze rezerwacji, w e-mailu z potwierdzeniem i na koncie podróżnego.
Kod QR
Podróżny skanuje kod QR z poziomu ustawień eSIM w telefonie.
Wpisanie ręczne
Kod aktywacyjny i adres SM-DP+, dla telefonów, które nie mogą skanować.
Instrukcje Airalo
Instrukcja instalacji krok po kroku z API, dla danego urządzenia i języka.
Link eSIM Cloud lub PDF
Link do udostępnienia lub PDF od Airalo z pełną instrukcją instalacji.
Bezpośrednia instalacja na iOS
Link instalacyjny jednym dotknięciem dla zgodnych iPhone'ów z obsługiwanymi wersjami iOS.
Dane klienta
Przypisz każdego klienta do numeru ICCID
Airalo rozpoznaje każdą eSIM po numerze ICCID i w tym modelu nie przechowuje danych osobowych Twoich podróżnych. Powiązanie podróżnego z eSIM należy do Ciebie, a PHPTRAVELS zapisuje je w rezerwacji.
- Klient
- Rezerwacja PHPTRAVELS
- Zamówienie Airalo
- ICCID
Ten łańcuch ułatwia obsługę klienta:Zgłoszenia do wsparciaProblemy z instalacjąWyszukiwanie zamówieńHistoria rezerwacjiStatus eSIM
Krok 7 · Twoja cena
Ustaw cenę sprzedaży i zarabiaj na każdej eSIM
Airalo pobiera od Ciebie koszt pakietu zgodnie z umową handlową. Ty decydujesz, ile zapłaci podróżny, w ramach umowy z Airalo.
Stała marża
Ta sama kwota doliczana do każdego pakietu.
Marża procentowa
Procent od ceny netto, więc marża rośnie przy większych pakietach.
Opłata serwisowa
Osobna opłata za zamówienie, widoczna przy płatności.
W cenie pakietu
eSIM w ramach pakietu wakacyjnego lub jako prezent do lotu.
- Lot do Dubaju
- Hotel w Dubaju
- Transfer z lotniska
- eSIM ZEA
Dlaczego biura podróży dodają eSIM
- Większy przychód z każdej rezerwacji
- Usługa dodatkowa potrzebna niemal każdemu podróżnemu za granicą
- Natychmiastowa dostawa cyfrowa, bez magazynu
- Podróżni wracają przy kolejnej podróży
Opcja voucherów. Airalo sprzedaje też vouchery eSIM: kupujesz kody aktywacyjne i przekazujesz je przez stronę, aplikację, CRM lub e-mail. Wybierz sposób zgodny z Twoją umową z Airalo.
Rozwiązywanie problemów
Gdy coś nie działa, najpierw sprawdź te punkty
Większość problemów dotyczy danych dostępowych, środowiska lub urządzenia. Przejdź listę dla problemu, który widzisz.
- Test połączenia kończy się błędem
- Client IDClient Secretaktywne konto partnerawłączony dostęp do APISandbox lub Productionwychodzący ruch HTTPS z serweraSSL
- Nie wyświetlają się pakiety eSIM
- Połączenie z APIdostępność pakietówśrodowiskofiltry kierunkówodpowiedź APIcache PHPTRAVELS
- Zamówienie się nie udaje
- Nieprawidłowy lub niedostępny pakietsaldo Airalobłąd tokenabłąd siecizłe środowiskochwilowy problem po stronie Airalo
- Kod QR się nie wyświetla
- Zamówienie zakończoneeSIM wydanaICCID zapisanydane instalacji zwróconepola QR w odpowiedzi API
- Podróżny nie może zainstalować eSIM
- Telefon obsługuje eSIMtelefon bez simlockawłaściwy kod QReSIM nie jest już zainstalowanaroaming włączonyAPN, jeśli wymagany
Kto za co odpowiada
PHPTRAVELS dostarcza oprogramowanie, Airalo dostarcza eSIM
Airalo jest zewnętrznym dostawcą. Relacja handlowa łączy Twoją firmę turystyczną z Airalo.
PHPTRAVELS
- Konektor Airalo i jego ustawienia
- Strony eSIM, wyszukiwarka i płatność
- Twoja marża i bramki płatnicze
- Vouchery, e-maile i ICCID w rezerwacji
- Wsparcie dla samej integracji
Airalo
- Akceptacja partnera i dane dostępowe API
- Ceny pakietów, prowizje i zasady salda
- Zasięg, sieci i dostępność pakietów
- Dostępność API i wydawanie eSIM
- Twoja umowa handlowa
Bezpieczeństwo
Chroń swoje dane dostępowe Airalo
- Uwierzytelniaj tylko z serwera, nigdy w JavaScript w przeglądarce
- Używaj HTTPS na stronie i w panelu
- Zabezpiecz panel administracyjny i ogranicz dostęp do serwera
- Aktualizuj PHPTRAVELS
- Obserwuj nietypową aktywność API
Airalo
Potrzebujesz pomocy z integracją?
Jeśli Twoje konto Airalo jest zatwierdzone, a integracja pokazuje błąd, otwórz zgłoszenie w koncie PHPTRAVELS i dołącz: wersję PHPTRAVELS, zrzut ekranu ustawień Airalo, wynik testu, przykładowy kierunek i pakiet, numer rezerwacji oraz komunikat błędu. Nigdy nie podawaj pełnego Client Secret.
Przeczytaj: jak biura podróży sprzedają eSIM onlineDokumentacja dla deweloperów Airalo
Nie. Potrzebujesz własnego, zatwierdzonego konta partnera Airalo. PHPTRAVELS dostarcza oprogramowanie i gotowy konektor Airalo.
Airalo przesyła Client ID i Client Secret po zatwierdzeniu Twojego konta partnera. PHPTRAVELS ich nie wydaje.
Klienci PHPTRAVELS mogą napisać do Rao Suhaib Khan, Head of Partnerships w Airalo, na adres rao.khan@airalo.com i wspomnieć, że korzystają z PHPTRAVELS.
Tak. Z zatwierdzonym kontem partnera Airalo i konektorem PHPTRAVELS obsługiwane pakiety Airalo pojawiają się na Twojej stronie, a rezerwacja pozostaje u Ciebie.
Tak, stałą lub procentową marżę albo opłatę serwisową, o ile jest to zgodne z Twoją umową handlową z Airalo.
Tak. Airalo ma tryb Sandbox, w którym zamówienia testowe nie wydają prawdziwych eSIM. Przejdź na Production dopiero wtedy, gdy cały proces działa.
Tak. Airalo oferuje pakiety lokalne, regionalne i globalne, zależnie od oferty dostępnej dla danego kierunku.
Za pomocą kodu QR, wpisując kod aktywacyjny i adres SM-DP+, według instrukcji krok po kroku od Airalo, z linku eSIM Cloud lub pliku PDF albo przez bezpośredni link instalacyjny na zgodnych iPhone'ach.
Nie. Airalo ma SDK dla PHP, Node.js i Python, ale konektor jest już w PHPTRAVELS. Wystarczy dodać dane dostępowe.
Odkryj więcej
Więcej o platformie
- eSIM
- Integracja API TiqetsBilety na atrakcje Tiqets w Twoim silniku rezerwacji
- Integracja API ViatorWycieczki i atrakcje Viator na Twojej stronie rezerwacji
- Integracja PKFARE APIWyszukiwanie, rezerwacja i PNR PKFARE w Twoim portalu
- Integracja API RateHawkHotele RateHawk w Twoim systemie rezerwacji, gotowy konektor
- API turystyczneAPI GDS, hoteli, wycieczek, aut i płatności