Changelog

v1.0.1（当前）

接口

• Webhook 新增 REFUND_COMPLETED（退款入账完成，含 BALANCE 同步退与异步售后放款）
• 回调 payload 增加 refundAmount、currency

文档

• Health status 与实现对齐为 UP
• 鉴权错误码与业务错误码分表说明
• openapi.yaml 补全 PackageVo 字段与 WebhookCallbackPayload

---

v1.0.0

接口

• 初始 Open API：health、套餐、下单、查单、Profile 运维、余额、充值申请、Webhook、地区列表
• 订单退款 POST /open-api/v1/esim/refund
• 出站回调：ORDER_PAID、DELIVERY_UPDATED

文档

• 在线对接文档 + OpenAPI 3.0 规范
• Apifox 前置签名脚本
• 各接口明细页（eSIM Access 风格参数表）
• 中英文切换（导航栏右上角）

约定

• 对外接口统一呈现平台订单/Profile 模型；部分操作可能返回 asyncStatus=PENDING 或退款 status=REFUNDING，属正常异步流程

---

计划（Roadmap）

• SMS 发送能力
• Outbox 失败监控 / 管理端重推