eSIM API 集成
Airalo API 集成：每趟行程都能卖 eSIM
将您的 Airalo 合作伙伴账户连接到 PHPTRAVELS，在自己的网站上销售本地、区域和全球 eSIM，与机票、酒店和旅游产品并列展示。连接器已经就绪：填入 Client ID 和 Client Secret，在沙盒中测试，同步套餐，设定价格，即可上线。
- 现成的 Airalo 连接器
- Airalo Partner API v2
- QR 码与安装步骤
- 自主设定售价
供应商
Airalo 是什么，旅行社为何销售它的 eSIM
Airalo 销售 eSIM：一种数字 SIM 套餐，旅客无需取出实体 SIM 卡即可安装在手机上。旅客不必在机场购买当地 SIM 卡，而是在出发前购买流量，几分钟即可完成安装。
通过 Airalo 合作伙伴 API，旅游企业可以在自己的网站或应用中销售这些产品。PHPTRAVELS 在 eSIM 模块中内置了 Airalo 连接器，因此 eSIM 可以与机票、酒店、接送、签证或旅游产品放进同一个购物车。
- 公司
- Airalo，eSIM 连接服务提供商
- 覆盖范围
- 据 Airalo 称覆盖 200 多个目的地
- 套餐
- 本地、区域和全球 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 从您的服务器将其发送到令牌接口，获取 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 允许您在配置中选择沙盒或生产环境。请先在沙盒中完成全部测试。
Partner API 流程
每笔 eSIM 销售背后的五个 Airalo API 调用
从页面上显示的第一个价格，到旅客邮箱中的 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按 ICCID 读取 eSIM：QR 码、激活码、SM-DP+ 地址以及 iOS 直接安装链接。
- 05安装步骤GET/v2/sims/{sim_iccid}/instructions
PHPTRAVELS根据旅客的设备和语言获取 Airalo 安装说明，并添加到凭证中。
第 3 至 5 步 · PHPTRAVELS 后台
在后台配置、测试并同步 Airalo
所有操作都在 PHPTRAVELS 后台的 eSIM 模块设置中完成。具体字段取决于您的 PHPTRAVELS 版本。
- 01启用 eSIM 模块打开模块设置，开启 Airalo eSIM 集成。
- 02填写凭证粘贴 Airalo 提供的 Client ID 和 Client Secret，选择沙盒环境，然后保存。
- 03测试连接点击测试按钮。PHPTRAVELS 会登录 Airalo，显示已连接状态，或显示需要修复的错误。
- 04同步套餐加载 Airalo 套餐，检查网站上的目的地、流量、有效期和价格是否正确。
环境
测试订单：不会开通真实 eSIM正式订单：真实 eSIM，从您的 Airalo 余额扣款
示例界面。您版本中的字段可能有所不同。
第 5 步 · eSIM 套餐
一个数据源，本地、区域和全球 eSIM 全覆盖
Airalo 提供三类套餐，您可以根据旅客的行程匹配合适的 eSIM。套餐、价格和库存始终实时来自 Airalo。
本地 eSIM
单一目的地，适合前往一个国家的行程。
示例美国 eSIM
区域 eSIM
覆盖同一地区的多个国家，适合多国行程。
示例欧洲 eSIM
全球 eSIM
覆盖多个地区的国家，适合长途或环球旅行。
示例全球 eSIM
- 向旅客展示的信息
- 目的地 · 套餐名称 · 流量 · 有效期 · 网络 · 覆盖范围 · 价格
- 常见流量规格：1 GB、3 GB、5 GB 和 10 GB，各有不同的有效期。
第 6 至 9 步 · 销售流程
旅客如何在您的网站上购买 Airalo eSIM
旅客全程无需离开您的网站。PHPTRAVELS 负责预订和支付，Airalo 负责开通 eSIM。
- 01旅客
打开您网站的 eSIM 页面
- 02旅客
选择目的地
- 03PHPTRAVELS
按您的售价展示 Airalo 套餐
- 04旅客
选择套餐
- 05旅客
通过您的支付网关预订并付款
- 06PHPTRAVELS
将订单发送至 Airalo API
- 07Airalo
开通 eSIM
- 08Airalo
返回 QR 码和安装信息
- 09PHPTRAVELS
通过邮件和账户向旅客发送 eSIM
eSIM 交付
旅客安装 eSIM 的五种方式
Airalo 为 API 合作伙伴支持多种安装方式。PHPTRAVELS 会将相关信息放在预订凭证、确认邮件和旅客账户中。
QR 码
旅客在手机的 eSIM 设置中扫描 QR 码。
手动输入
提供激活码和 SM-DP+ 地址，适用于无法扫码的手机。
Airalo 安装说明
来自 API 的分步安装说明，按设备和语言提供。
eSIM Cloud 链接或 PDF
Airalo 提供的分享链接或 PDF，包含完整安装指南。
iOS 直接安装
适用于受支持 iOS 版本的兼容 iPhone，一键安装链接。
客户数据
将每位客户与 ICCID 关联
Airalo 通过 ICCID 识别每张 eSIM，在此流程中不会存储您旅客的个人数据。旅客与 eSIM 之间的关联需要由您保存，PHPTRAVELS 会在预订记录中完成这项工作。
- 客户
- PHPTRAVELS 预订
- Airalo 订单
- ICCID
这条关联链让客服工作更轻松：客服请求安装问题订单查询预订历史eSIM 状态
第 7 步 · 您的售价
设定售价，每张 eSIM 都能赚取收益
Airalo 按照您的商务协议向您收取套餐成本。在与 Airalo 的协议范围内，旅客支付多少由您决定。
固定加价
每个套餐加上相同的金额。
百分比加价
按净价的一定比例加价，套餐越大，利润越高。
服务费
每笔订单单独收取，在结账时显示。
打包销售
将 eSIM 包含在度假套餐中，或作为机票赠品。
- 飞往迪拜的航班
- 迪拜酒店
- 机场接送
- 阿联酋 eSIM
旅行社为何增加 eSIM
- 提高每笔预订的收入
- 几乎每位国际旅客都需要的附加产品
- 即时数字交付，无需库存
- 旅客下次出行还会回来
兑换券方式. Airalo 还销售 eSIM 兑换券：您购买激活码，再通过网站、应用、CRM 或邮件发放。请选择符合您 Airalo 协议的方式。
故障排查
出现问题时，请先检查以下项目
大多数问题源于凭证、环境或设备。请针对您遇到的问题逐项检查。
- 连接测试失败
- Client IDClient Secret合作伙伴账户已激活已开通 API 权限沙盒或生产环境服务器出站 HTTPSSSL
- 没有显示 eSIM 套餐
- API 连接套餐库存环境目的地筛选API 响应PHPTRAVELS 缓存
- 订单失败
- 套餐无效或不可用Airalo 余额令牌失败网络错误环境错误Airalo 临时故障
- QR 码未显示
- 订单已完成eSIM 已开通ICCID 已保存已返回安装数据API 响应中的 QR 字段
- 旅客无法安装
- 手机支持 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。
不提供。您需要拥有自己已获批准的 Airalo 合作伙伴账户。PHPTRAVELS 提供软件和现成的 Airalo 连接器。
Airalo 在批准您的合作伙伴账户后会发送 Client ID 和 Client Secret。PHPTRAVELS 不发放这些凭证。
PHPTRAVELS 客户可发邮件至 rao.khan@airalo.com，联系 Airalo 合作伙伴关系负责人 Rao Suhaib Khan，并说明您使用 PHPTRAVELS。
可以。拥有已获批准的 Airalo 合作伙伴账户并使用 PHPTRAVELS 连接器后，支持的 Airalo 套餐会显示在您自己的网站上，预订也全程在您的网站完成。
可以，支持固定加价、百分比加价或服务费，只要符合您与 Airalo 的商务协议即可。
可以。Airalo 提供沙盒模式，测试订单不会开通真实 eSIM。完整流程运行正常后再切换到生产环境。
是的。Airalo 提供本地、区域和全球套餐，具体取决于各目的地的可用库存。
可以扫描 QR 码，输入激活码和 SM-DP+ 地址，按照 Airalo 的分步说明操作，使用 eSIM Cloud 链接或 PDF，或在兼容的 iPhone 上使用直接安装链接。
不需要。Airalo 提供 PHP、Node.js 和 Python SDK，但连接器已内置于 PHPTRAVELS。您只需填入凭证。