Интеграция eSIM API
Интеграция API Airalo: продавайте 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 туристическая компания может продавать этот ассортимент на своём сайте или в приложении. В модуле eSIM PHPTRAVELS есть коннектор Airalo, поэтому eSIM становится ещё одним продуктом в той же корзине, что и авиабилет, отель, трансфер, виза или тур.
- Компания
- Airalo, провайдер связи eSIM
- Покрытие
- Более 200 направлений, по данным Airalo
- Пакеты
- Локальные, региональные и глобальные eSIM
- API
- Partner API v2 · REST · токен Bearer
- SDK
- PHP · Node.js · Python
- В PHPTRAVELS
- Готовый коннектор в модуле eSIM
Шаг 1 · Партнёрский аккаунт
Подайте заявку на партнёрский аккаунт Airalo
Для доступа к API Airalo нужен партнёрский договор с Airalo. PHPTRAVELS не выдаёт аккаунты и ключи Airalo: вы подаёте заявку, Airalo проверяет вашу компанию и присылает учётные данные.
Что отправить в Airalo
- Название компании и сайт
- Страна и вид деятельности
- Ожидаемый объём продаж eSIM
- Целевые рынки и направления
- B2C, B2B или оба варианта
- Что вы используете PHPTRAVELS
Шаг 2 · Учётные данные
Client ID, Client Secret и токен доступа
После одобрения аккаунта Airalo вы получаете Client ID и Client Secret. PHPTRAVELS отправляет их со своего сервера на эндпоинт токена, получает токен доступа 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>
- Только на сервере
- Токен запрашивает ваш сервер PHPTRAVELS. Client Secret никогда не попадает в браузер.
- Повторное использование токена
- Коннектор хранит токен до истечения срока действия и не запрашивает новый при каждом поиске.
- Храните секрет в тайне
- Никогда не размещайте Client Secret в публичном JavaScript, HTML, открытом Git-репозитории, на скриншоте или в сообщении на форуме.
- Один аккаунт, два режима
- В настройках Airalo можно выбрать Sandbox или Production. Сначала протестируйте всё в Sandbox.
Сценарий Partner API
Пять вызовов API Airalo за каждой продажей eSIM
От первой цены на экране до QR-кода во входящих у путешественника коннектор использует одни и те же пять вызовов. Для каждого указано, что PHPTRAVELS делает с ответом.
- 01Получение токенаPOST/v2/token
PHPTRAVELSАвторизуется по вашим Client ID и Client Secret и хранит токен Bearer на сервере.
- 02Список пакетовGET/v2/packages
PHPTRAVELSСинхронизирует локальные, региональные и глобальные пакеты с объёмом трафика, сроком действия, покрытием и нетто-ценой, затем применяет вашу цену.
- 03Оформление заказаPOST/v2/orders
PHPTRAVELSПосле оплаты заказывает выбранный ID пакета и количество и сохраняет заказ Airalo в бронировании.
- 04Получение eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSПолучает eSIM по ICCID: QR-код, код активации, адрес SM-DP+ и прямую ссылку для установки на iOS.
- 05Шаги установкиGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSПолучает инструкции Airalo по установке для устройства и языка путешественника и добавляет их в ваучер.
Шаги 3–5 · Панель PHPTRAVELS
Настройте, проверьте и синхронизируйте Airalo в панели управления
Всё делается в настройках модуля eSIM в панели управления PHPTRAVELS. Конкретные поля зависят от вашей версии PHPTRAVELS.
- 01Включите модуль eSIMОткройте настройки модуля и включите интеграцию eSIM Airalo.
- 02Введите учётные данныеВставьте Client ID и Client Secret от Airalo, выберите Sandbox и сохраните.
- 03Проверьте подключениеНажмите кнопку Test. PHPTRAVELS подключается к Airalo и показывает статус подключения или ошибку, которую нужно исправить.
- 04Синхронизируйте пакетыЗагрузите пакеты Airalo и проверьте, что направления, трафик, срок действия и цены правильно отображаются на сайте.
Среда
Тестовые заказы: реальная eSIM не выпускаетсяРеальные заказы: настоящие eSIM, оплата с вашего баланса Airalo
Пример экрана. Поля в вашей версии могут отличаться.
Шаг 5 · Пакеты eSIM
Локальные, региональные и глобальные eSIM из одного источника
Airalo предлагает три типа пакетов, чтобы eSIM подходила под маршрут путешественника. Пакеты, цены и наличие всегда поступают от Airalo в реальном времени.
Локальная eSIM
Одно направление, для поездки в одну страну.
ПримерeSIM США
Региональная eSIM
Несколько стран одного региона, для поездки по нескольким странам.
ПримерeSIM Европа
Глобальная eSIM
Страны в разных регионах, для долгих поездок и кругосветных путешествий.
ПримерГлобальная eSIM
- Что видит путешественник
- Направление · название пакета · трафик · срок действия · сеть · покрытие · цена
- Типичные объёмы трафика: 1 ГБ, 3 ГБ, 5 ГБ и 10 ГБ, у каждого свой срок действия.
Шаги 6–9 · Продажа
Как путешественник покупает eSIM Airalo на вашем сайте
Путешественник не покидает ваш сайт. PHPTRAVELS ведёт бронирование и оплату, Airalo выпускает eSIM.
- 01Путешественник
Открывает раздел eSIM на вашем сайте
- 02Путешественник
Выбирает направление
- 03PHPTRAVELS
Показывает пакеты Airalo по вашей цене
- 04Путешественник
Выбирает пакет
- 05Путешественник
Бронирует и оплачивает через ваш платёжный шлюз
- 06PHPTRAVELS
Отправляет заказ в API Airalo
- 07Airalo
Выпускает eSIM
- 08Airalo
Возвращает QR-код и данные для установки
- 09PHPTRAVELS
Отправляет eSIM путешественнику по email и в личный кабинет
Доставка 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 сохраняет её в бронировании.
- Клиент
- Бронирование PHPTRAVELS
- Заказ Airalo
- ICCID
Эта цепочка упрощает поддержку:Обращения в поддержкуПроблемы с установкойПоиск заказаИстория бронированийСтатус eSIM
Шаг 7 · Ваша цена
Задайте цену продажи и зарабатывайте на каждой eSIM
Airalo списывает с вас стоимость пакета по условиям коммерческого договора. Сколько платит путешественник, решаете вы в рамках договора с Airalo.
Фиксированная наценка
Одна и та же сумма сверху на каждый пакет.
Процентная наценка
Процент от нетто-цены, поэтому маржа растёт с объёмом пакета.
Сервисный сбор
Отдельный сбор за заказ, который показывается при оплате.
В составе пакета
eSIM в составе турпакета или в подарок к авиабилету.
- Перелёт в Дубай
- Отель в Дубае
- Трансфер из аэропорта
- eSIM ОАЭ
Зачем агентства добавляют eSIM
- Больше выручки с каждого бронирования
- Допуслуга, нужная почти каждому международному путешественнику
- Мгновенная цифровая доставка, без склада
- Путешественники возвращаются за следующей поездкой
Вариант с ваучерами. Airalo также продаёт ваучеры eSIM: вы покупаете коды активации и распространяете их через сайт, приложение, CRM или email. Выберите способ, который соответствует вашему договору с 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 для разработчиков
Нет. Вам нужен собственный одобренный партнёрский аккаунт Airalo. PHPTRAVELS предоставляет ПО и готовый коннектор Airalo.
Airalo присылает Client ID и Client Secret после одобрения вашего партнёрского аккаунта. PHPTRAVELS их не выдаёт.
Клиенты PHPTRAVELS могут написать Rao Suhaib Khan, руководителю отдела партнёрств 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. Вам нужно только добавить учётные данные.
Узнайте больше
Ещё о платформе
- eSIM
- Интеграция API TiqetsБилеты Tiqets на достопримечательности в вашем движке
- Интеграция Viator APIТуры и активности Viator на вашем сайте бронирования
- Интеграция PKFARE APIПоиск, бронирование и PNR PKFARE в вашем портале
- Интеграция API RateHawkОтели RateHawk в вашей системе бронирования, готовый коннектор
- Travel APIAPI GDS, отелей, туров, авто и платежей