下单

POST

Create Order

POST {baseUrl}/open-api/v1/esim/order

创建 eSIM 订单并从合作伙伴 BALANCE 钱包扣款。成功后返回 orderNo，Profile 异步分配；可通过 查单 或 Webhook 获取发货结果。

下单步骤

1. 生成全局唯一 transactionId（幂等键，重复提交返回同一订单）。
2. 从 套餐列表 获取 packageCode 与 price。
3. 组装 items[]（单个商品也传一行：packageCode + quantity + price）。
4. 填写 amount = Σ(price × quantity)，须与平台结算价一致。
5. 填写 notifyEmail；部分套餐需传 estimatedUseTime（yyyy-MM-dd）。
6. 调用成功后保存 orderNo，轮询查单或等待 DELIVERY_UPDATED 回调。

成功下单后可在 查单接口 用 orderNo 或 transactionId 查询发货进度。

请求参数

加载字段说明…

请求示例

示例由 OpenAPI schema 自动生成；schema 中声明的 example 优先展示。

加载请求示例…

响应字段

加载字段说明…

响应示例

示例由 OpenAPI schema 自动生成，覆盖上方字段表全部属性；实际响应中无值的字段可能省略。

加载响应示例…