Демоверсія

Інтеграція eSIM API

Інтеграція Airalo API: продавайте eSIM до кожної подорожі

Підключіть партнерський акаунт Airalo до PHPTRAVELS і продавайте локальні, регіональні та глобальні eSIM на власному сайті поруч з авіаквитками, готелями та турами. Конектор готовий: додайте Client ID і Client Secret, протестуйте в sandbox, синхронізуйте пакети, встановіть ціну та запускайтеся.

  • Готовий конектор Airalo
  • Airalo Partner API v2
  • QR-код і кроки встановлення
  • Ваша власна ціна продажу

Постачальник

Що таке Airalo і чому турагенції продають її eSIM

Airalo продає eSIM: цифрові SIM-пакети, які мандрівник встановлює на телефон без виймання фізичної SIM-картки. Замість купівлі місцевої SIM в аеропорту мандрівник купує трафік ще до поїздки та встановлює його за кілька хвилин.

Через Airalo Partner API туристичний бізнес може продавати ці пакети на власному сайті чи в застосунку. PHPTRAVELS має конектор Airalo в модулі eSIM, тож eSIM стає ще одним продуктом у тому самому кошику, що й переліт, готель, трансфер, віза чи тур.

Пов'язане:eSIMTravel APIІнтеграція туристичних API

Довідка про постачальника
Компанія
Airalo, провайдер зв'язку eSIM
Покриття
Понад 200 напрямків, за даними Airalo
Пакети
Локальні, регіональні та глобальні eSIM
API
Partner API v2 · REST · токен Bearer
SDK
PHP · Node.js · Python
У PHPTRAVELS
Готовий конектор у модулі eSIM

Крок 1 · Партнерський акаунт

Подайте заявку на партнерський акаунт Airalo

Доступ до Airalo API потребує партнерської угоди з Airalo. PHPTRAVELS не видає акаунти чи ключі Airalo: ви подаєте заявку, Airalo перевіряє ваш бізнес і надсилає облікові дані.

Що надіслати Airalo

  • Назву компанії та сайт
  • Країну та тип бізнесу
  • Очікуваний обсяг продажів eSIM
  • Цільові ринки та напрямки
  • B2C, B2B або обидва
  • Те, що ви використовуєте PHPTRAVELS

Крок 2 · Облікові дані

Client ID, Client Secret і токен доступу

Коли Airalo схвалює ваш акаунт, ви отримуєте Client ID і Client Secret. PHPTRAVELS надсилає їх на endpoint токена з вашого сервера, отримує токен доступу Bearer і використовує його для кожного запиту пакетів, замовлень і 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>
client_credentialsPartner API v2Bearer token · Sandbox → Production
Лише на сервері
Токен запитує ваш сервер PHPTRAVELS. Client Secret ніколи не потрапляє в браузер.
Повторне використання токена
Конектор зберігає токен до завершення його терміну дії, тому не запитує новий при кожному пошуку.
Тримайте секрет у таємниці
Ніколи не розміщуйте Client Secret у публічному JavaScript, HTML, відкритому Git-репозиторії, на скриншоті чи у дописі на форумі.
Один акаунт, два режими
Airalo дає змогу обрати Sandbox або Production у налаштуваннях. Спершу протестуйте все в Sandbox.

Потік Partner API

П'ять викликів Airalo API за кожним продажем eSIM

Від першої ціни на екрані до QR-коду в пошті мандрівника конектор використовує ті самі п'ять викликів. Для кожного показано, що PHPTRAVELS робить із відповіддю.

  1. 01Отримати токенPOST/v2/token

    PHPTRAVELSАвторизується за вашими Client ID і Client Secret та зберігає токен Bearer на сервері.

  2. 02Список пакетівGET/v2/packages

    PHPTRAVELSСинхронізує локальні, регіональні та глобальні пакети з трафіком, терміном дії, покриттям і нетто-ціною, а потім застосовує вашу ціну.

  3. 03Створити замовленняPOST/v2/orders

    PHPTRAVELSПісля оплати замовляє обраний ID пакета та кількість і зберігає замовлення Airalo в бронюванні.

  4. 04Отримати eSIMGET/v2/sims/{sim_iccid}

    PHPTRAVELSЗчитує eSIM за ICCID: QR-код, код активації, адресу SM-DP+ і пряме посилання для встановлення на iOS.

  5. 05Кроки встановленняGET/v2/sims/{sim_iccid}/instructions

    PHPTRAVELSОтримує інструкції Airalo зі встановлення для пристрою та мови мандрівника й додає їх до ваучера.

Кроки 3–5 · Адмінпанель PHPTRAVELS

Налаштуйте, протестуйте та синхронізуйте Airalo в адмінпанелі

Усе відбувається в налаштуваннях модуля eSIM вашої адмінпанелі PHPTRAVELS. Точний набір полів залежить від версії PHPTRAVELS.

  1. 01Увімкніть модуль eSIMВідкрийте налаштування модуля та увімкніть інтеграцію Airalo eSIM.
  2. 02Введіть облікові даніВставте Client ID і Client Secret від Airalo, оберіть Sandbox і збережіть.
  3. 03Перевірте з'єднанняНатисніть кнопку перевірки. PHPTRAVELS авторизується в Airalo і покаже статус підключення або помилку, яку треба виправити.
  4. 04Синхронізуйте пакетиЗавантажте пакети Airalo та перевірте, що напрямки, трафік, термін дії та ціни коректно відображаються на вашому сайті.
Модуль eSIM · AiraloAiralo

Середовище

Тестові замовлення: справжні eSIM не створюютьсяРеальні замовлення: справжні eSIM, оплата з балансу Airalo

Client ID7f3c…a91e
Client Secret••••••••••••••••
Націнка15% до нетто-ціни
СтатусПідключено

Приклад екрана. Поля у вашій версії можуть відрізнятися.

Крок 5 · Пакети eSIM

Локальні, регіональні та глобальні eSIM з одного каналу

Airalo повертає три типи пакетів, тож ви можете підібрати eSIM під маршрут мандрівника. Пакети, ціни та наявність завжди надходять від Airalo в реальному часі.

  • Локальна eSIM

    Один напрямок, для поїздки в одну країну.

    ПрикладeSIM для США

  • Регіональна eSIM

    Кілька країн одного регіону, для поїздки кількома країнами.

    ПрикладeSIM для Європи

  • Глобальна eSIM

    Країни в кількох регіонах, для довгих подорожей або навколосвітніх турів.

    ПрикладГлобальна eSIM

Що бачить мандрівник
Напрямок · назва пакета · трафік · термін дії · мережа · покриття · ціна
Типові обсяги трафіку: 1 ГБ, 3 ГБ, 5 ГБ і 10 ГБ, кожен зі своїм терміном дії.

Кроки 6–9 · Продаж

Як мандрівник купує eSIM Airalo на вашому сайті

Мандрівник не залишає ваш сайт. PHPTRAVELS проводить бронювання та оплату, Airalo створює eSIM.

  1. 01Мандрівник

    Відкриває розділ eSIM на вашому сайті

  2. 02Мандрівник

    Обирає напрямок

  3. 03PHPTRAVELS

    Показує пакети Airalo з вашою ціною

  4. 04Мандрівник

    Обирає пакет

  5. 05Мандрівник

    Бронює та оплачує через ваш платіжний шлюз

  6. 06PHPTRAVELS

    Надсилає замовлення в Airalo API

  7. 07Airalo

    Створює eSIM

  8. 08Airalo

    Повертає QR-код і дані для встановлення

  9. 09PHPTRAVELS

    Надсилає мандрівнику eSIM електронною поштою та в особистий кабінет

Доставка eSIM

П'ять способів, як мандрівник може встановити eSIM

Airalo підтримує кілька сценаріїв встановлення для API-партнерів. PHPTRAVELS додає дані до ваучера бронювання, листа-підтвердження та особистого кабінету мандрівника.

  • QR-код

    Мандрівник сканує QR-код у налаштуваннях eSIM телефона.

  • Ручне введення

    Код активації та адреса SM-DP+ для телефонів, які не можуть сканувати.

  • Інструкції Airalo

    Покрокові інструкції зі встановлення з API для кожного пристрою та мови.

  • Посилання eSIM Cloud або PDF

    Посилання або PDF від Airalo з повною інструкцією зі встановлення.

  • Пряме встановлення на iOS

    Посилання для встановлення одним дотиком на сумісних iPhone з підтримуваними версіями iOS.

Дані клієнтів

Прив'яжіть кожного клієнта до ICCID

Airalo ідентифікує кожну eSIM за ICCID і в цьому сценарії не зберігає персональні дані ваших мандрівників. Зберігати зв'язок між мандрівником і eSIM маєте ви, і PHPTRAVELS робить це в бронюванні.

  1. Клієнт
  2. Бронювання PHPTRAVELS
  3. Замовлення Airalo
  4. ICCID

Цей ланцюжок спрощує підтримку:Звернення до підтримкиПроблеми зі встановленнямПошук замовленняІсторія бронюваньСтатус eSIM

Крок 7 · Ваша ціна

Встановіть ціну продажу та заробляйте на кожній eSIM

Airalo стягує з вас вартість пакета згідно з комерційною угодою. Ви вирішуєте, скільки платить мандрівник, у межах угоди з Airalo.

  • Фіксована націнка

    Однакова сума понад вартість кожного пакета.

  • Відсоткова націнка

    Відсоток від нетто-ціни, тож маржа зростає з більшими пакетами.

  • Сервісний збір

    Окремий збір за замовлення, показаний під час оформлення.

  • У складі пакета

    eSIM у складі турпакета або в подарунок до авіаквитка.

Приклад крос-продажу
  1. Переліт до Дубая
  2. Готель у Дубаї
  3. Трансфер з аеропорту
  4. eSIM для ОАЕ

Чому агенції додають eSIM

  • Більше доходу з кожного бронювання
  • Додаткова послуга, потрібна майже кожному міжнародному мандрівнику
  • Миттєва цифрова доставка без складу
  • Мандрівники повертаються для наступної поїздки

Варіант із ваучерами. Airalo також продає ваучери eSIM: ви купуєте коди активації та роздаєте їх через сайт, застосунок, CRM чи електронну пошту. Оберіть спосіб, що відповідає вашій угоді з Airalo.

Усунення проблем

Якщо щось не працює, спершу перевірте це

Більшість проблем пов'язані з обліковими даними, середовищем або пристроєм. Пройдіть списком для вашої проблеми.

Перевірка з'єднання не проходить
Client IDClient Secretпартнерський акаунт активнийдоступ до API увімкненоSandbox чи Productionвихідний HTTPS з вашого сервераSSL
Пакети eSIM не відображаються
З'єднання з APIнаявність пакетівсередовищефільтри напрямківвідповідь APIкеш PHPTRAVELS
Замовлення не проходить
Недійсний або недоступний пакетбаланс Airaloпомилка токенамережева помилканеправильне середовищетимчасова проблема Airalo
QR-код не відображається
Замовлення завершеноeSIM створеноICCID збереженодані для встановлення повернутополя QR у відповіді API
Мандрівник не може встановити eSIM
Телефон підтримує eSIMтелефон розблокованоправильний QR-кодeSIM ще не встановленороумінг увімкненоAPN за потреби

Хто за що відповідає

PHPTRAVELS відповідає за програмне забезпечення, Airalo за eSIM

Airalo є зовнішнім постачальником. Комерційні відносини існують між вашим туристичним бізнесом і Airalo.

PHPTRAVELS

  • Конектор Airalo та його налаштування
  • Сторінки eSIM, пошук і оформлення замовлення
  • Ваша націнка та платіжні шлюзи
  • Ваучери, листи та ICCID у бронюванні
  • Підтримка самої інтеграції

Airalo

  • Схвалення партнера та облікові дані API
  • Ціни пакетів, комісії та правила балансу
  • Покриття, мережі та наявність пакетів
  • Доступність API та створення eSIM
  • Ваша комерційна угода

Безпека

Захистіть облікові дані Airalo

  • Авторизуйтеся лише на сервері, ніколи в JavaScript браузера
  • Використовуйте HTTPS для сайту та адмінпанелі
  • Захистіть адмінпанель і обмежте доступ до сервера
  • Регулярно оновлюйте PHPTRAVELS
  • Відстежуйте незвичну активність в API
  • Airalo

Потрібна допомога з інтеграцією?

Якщо ваш акаунт Airalo схвалено, але інтеграція показує помилку, створіть запит у підтримку у своєму акаунті PHPTRAVELS і додайте: версію PHPTRAVELS, скриншот налаштувань Airalo, результат перевірки, приклад напрямку та пакета, номер бронювання й текст помилки. Ніколи не надсилайте повний Client Secret.

Створити запит у підтримкуПереглянути ціниЗамовити демо

Читати: як турагенціям продавати eSIM онлайнДокументація Airalo для розробників

FAQ

Інтеграція Airalo API: запитання агенцій

Відділ продажів

Ні. Вам потрібен власний схвалений партнерський акаунт Airalo. PHPTRAVELS надає програмне забезпечення та готовий конектор Airalo.

Airalo надсилає Client ID і Client Secret після схвалення вашого партнерського акаунта. PHPTRAVELS їх не видає.

Клієнти PHPTRAVELS можуть написати Rao Suhaib Khan, Head of Partnerships в Airalo, на rao.khan@airalo.com і зазначити, що використовують PHPTRAVELS.

Так. Зі схваленим партнерським акаунтом Airalo та конектором PHPTRAVELS підтримувані пакети Airalo з'являються на вашому сайті, а бронювання залишається у вас.

Так, фіксовану чи відсоткову націнку або сервісний збір, якщо це відповідає вашій комерційній угоді з Airalo.

Так. Airalo має режим Sandbox, у якому тестові замовлення не створюють справжніх eSIM. Перемикайтеся на Production лише тоді, коли весь процес працює.

Так. Airalo пропонує локальні, регіональні та глобальні пакети залежно від наявності для кожного напрямку.

За QR-кодом, введенням коду активації та адреси SM-DP+, за покроковими інструкціями Airalo, через посилання eSIM Cloud або PDF чи за прямим посиланням на сумісних iPhone.

Ні. Airalo має SDK для PHP, Node.js і Python, але конектор уже є в PHPTRAVELS. Вам потрібно лише додати облікові дані.

Дізнайтеся більше

Ще про платформу