根据旅行者的目的地和行程时长匹配流量套餐。
在用户结账前，从后端查询目录，展示单一国家或区域套餐及其流量额度、有效期和设备要求。
# Install the CLI
# curl -fsSL https://cli.bird.com/install.sh | sh
bird esim offers list结账与开通
从结账流程开通 eSIM 配置文件，重试时不会重复扣费。
在您自己的结账流程中向客户收费，同时由您的 Bird 组织钱包支付运营商开通费用。由于运营商配置文件分配是异步进行的，Bird 会跟踪订单从付款到交付的状态，用户可以关闭浏览器，稍后回来即可使用已就绪的 eSIM。
收费前锁定报价
在客户付款前获取实时价格、覆盖条款和国家身份验证规则。随订单传入已接受的报价版本，可防止结账时价格意外变动；周期性套餐会提前显示续订计划。
防止网络不稳定时重复下单
旅行者常在机场 Wi-Fi 或不稳定的网络下购买流量。为订单请求附加幂等键，并在响应丢失时检查现有订单 ID，这样网络重试会继续原有购买，而不会产生第二笔扣费。
托管安装与用量
无需自建安装流程，即可发送私密设置链接并展示实时用量。
eSIM 开通后，生成托管设置链接，或直接通过电子邮件或 SMS 发送给旅行者。客户无需登录工作区即可获得二维码以及 iOS 或 Android 安装指引；您的团队则可分别跟踪消息送达、设备安装和首次数据使用。
保护激活凭据并撤销误发链接
安装凭据受专用 API 权限保护，普通的订单读取密钥无法暴露原始激活码。如果设置链接发到了错误的电子邮件地址或电话号码，可检查其有效期并撤销该 URL，阻止后续访问，同时不影响已安装的配置文件。
显示剩余流量及运营商时间戳
直接在您的应用中显示客户的总流量额度、套餐到期日期和已上报的用量。由于移动网络上报用量存在延迟，Bird 会附带精确的观测时间戳，让客户和支持人员能区分最新的余额读数和尚未上报的数据。
充值与续订
为使用中的线路充值并安排续订，无需再次安装。
旅行者在途中流量不足时，先查询与其已安装 eSIM 配置文件兼容的套餐，再展示结账选项。购买兼容的充值包后，新流量套餐会直接添加到其手机上已激活的线路，无需再次扫描二维码或更改蜂窝网络设置。
为长途旅行或团队自动续订套餐
对于支持自动续订的套餐，在结账时指定订阅者并接受周期价格和计费周期。您可以跨计费周期跟踪钱包付款和套餐交付，并在行程结束时取消后续续订，同时保留当前周期的流量。
将线路映射到您自己的用户和员工账户
将您的 Bird API 密钥保存在服务器端，并在数据库中将每个订单和 eSIM ID 绑定到已登录用户。您的应用继续掌控身份验证、价格加成和支持流程，Bird 则在底层负责运营商开通。
eSIM API 常见问题
我可以用 eSIM API 构建什么？
购买前需要准备什么？
购买响应中断时应如何处理？
订单完成是否意味着客户已上线？
规模扩展
不失控。
在工作区中组织团队，控制 API 访问权限，通过审计日志追踪变更。
组织
Harbor
访问权限仅限于其所在工作区。
生产环境/API 密钥
旅行应用
活跃Alex Lee
管理员
今天 · UTC
审计日志
组织
Harbor
访问权限仅限于其所在工作区。
生产环境/API 密钥
旅行应用
活跃Alex Lee
管理员
今天 · UTC
审计日志
组织
Harbor
访问权限仅限于其所在工作区。
生产环境/API 密钥
旅行应用
活跃Alex Lee
管理员
今天 · UTC
审计日志