用一套 REST API,把覆盖 200 个国家的批发级 eSIM 流量套餐接入您的 App、平台或商城: 目录、下单、续费、用量与完整的生命周期管理。
企业通过接入批发级 eSIM,为现有产品增加一块联网业务的收入。
在预订环节把 eSIM 作为加购项推荐。旅客一落地就有网,每卖出一个套餐您都拿到差价。
按批发价采购 eSIM,用自己的渠道、自己的定价和包装去销售。
一次集成,即可跨境开通并监控设备与车辆的联网状态。
把国际流量套餐做成原生功能,与支付、银行或会员权益并列。
这套 API 覆盖全流程:从查询批发套餐,到管理已经在外面使用中的 eSIM。
查询 200 个国家全部在售流量套餐的批发价,并在下单前确认账户余额。
即时开通新的 eSIM,也可为已有的 eSIM 续费。下单接口会返回二维码与激活信息,可直接交付给您的用户。
管理您签发的所有 eSIM:查询状态与流量用量、暂停或注销线路、查看网络事件、发送短信。
注册回调地址,实时接收订单与 eSIM 生命周期事件的通知,不必反复轮询。
API 合作伙伴按批发价采购流量套餐,并自行决定零售价。 目录涵盖 200 个国家、450 多张网络的本地、区域与全球套餐,一次集成就能覆盖用户所有的目的地。 结算采用余额方式,非常简单:为账户充值,每笔订单按您的批发价从余额中扣除。
如果您不想自己从零搭建,更希望直接拿到一个完整的商城,我们的 白牌 eSIM 平台 提供带您自有品牌的网站、后台与移动 App,底层用的是同一套基础设施。
每一次 API 调用都通过 HMAC-SHA256 签名鉴权,签名基于请求时间戳、唯一请求标识、您的访问码以及请求体计算得出, 既保证完整性,也防止重放攻击。文档中提供了可直接使用的 Node.js、Python 与 PHP 签名示例。
POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-... # unique UUID v4
RT-Timestamp: 1752403200000 # ms since epoch
RT-Signature: A3F0... # HMAC-SHA256, see docs
{ "package_code": "...", "quantity": 1 }在 eSIMfly 注册企业账户,并告诉我们您的使用场景与预计业务量。
在企业后台创建和管理访问凭证,并为账户充值。
按照文档查询套餐、下一个测试订单;如有需要,再为异步开通的 eSIM 注册一个 Webhook。
eSIMfly API 是一套 REST 接口,让您以编程方式按批发价购买、开通和管理 eSIM。您可以查询套餐目录、创建订单、为套餐续费、监控用量,并在自己的应用里管理 eSIM 的完整生命周期(激活、暂停、注销),覆盖 200 个国家、450 多张网络。
这套 API 面向希望把 eSIM 联网能力集成进自家产品的企业:旅行 App 与预订平台、电信分销商与虚拟运营商、物联网与车队管理平台,以及任何想给用户提供国际流量、又不想逐一去和运营商谈判的服务。
请求通过 HMAC-SHA256 签名进行鉴权。每个请求都包含访问码、唯一的请求标识、时间戳,以及用您的密钥计算出的签名,以此保证请求的完整性并防止重放攻击。文档中提供 Node.js、Python 与 PHP 的示例代码。
在 eSIMfly 注册企业账户,然后在企业后台生成 API 密钥。批发价分档取决于业务量:请联系我们的商务团队,按您预计的订单量了解具体价格。
支持。当一张异步开通的 eSIM 准备就绪时,Webhook 会通知您:个别运营商(例如日本的 KDDI)需要等几分钟,这时您不必反复轮询,而是会收到一个带签名的 POST,里面包含 eSIM 的数据。多数供应方会在下单响应中同步开通;状态与用量则通过相应的接口查询。
每个账户每小时 1000 次请求。超过 5 分钟的旧请求会被拒绝,这是防重放机制的一部分。如果您的集成需要更高的限额,请联系商务团队。
npm install @esimfly/sdk 为整套 API 提供带类型的封装:HMAC 签名、唯一请求 ID、幂等下单、 按节奏同步目录,以及 Webhook 签名校验,全都内置。 零依赖,Node.js 18+,MIT 许可,开源。PHP 与 Python 的 SDK 正在路上。
在用 AI 智能体?把托管版 MCP 服务器 https://mcp.esimfly.net/mcp 加到 Claude、ChatGPT 或 Cursor 里,用企业账户登录即可,不用粘贴任何密钥。可以直接对着线上 API 搜套餐、 查用量、诊断 eSIM:默认只读,任何下单操作前都有一步确认。更想在本地跑? npx -y @esimfly/mcp.
可直接运行的 Node.js 代码,从第一个请求一直讲到生产环境的 Webhook。
四个基础模块、签名鉴权、同步开通与 Webhook 的区别、评估供应商的检查清单,以及那些只在生产环境才会冒出来的问题。
阅读指南