退款说明
平台对外提供两种退款相关能力，请勿混淆。
对比
| Profile cancel/revoke | 订单 refund | |
|---|---|---|
| 路径 | /esim/profile/cancel 或 /revoke | /esim/refund |
| 作用 | 向平台发起 Profile 取消 | 计算退款金额并退回 BALANCE 钱包 |
| 钱包 | 不自动退 | 自动退（异步完成时见 status） |
| 典型场景 | 仅作废 eSIM、不需立即退钱 | 用户退款、对账 |
Profile 取消
请求体（三选一定位 Profile）：
json
{
"profileId": 123,
"iccid": "8986...",
"esimTranNo": "..."
}响应中 asyncStatus：
| 值 | 含义 |
|---|---|
COMPLETED | 同步处理完成 |
PENDING | 异步处理中，请稍后查单或等待回调 |
订单退款
json
{
"orderNo": "ORD20260101001",
"remark": "用户申请退款",
"items": [
{
"itemNo": "ITEM001",
"profileTokens": ["8986000000000000001"]
}
]
}- 省略
items：退订单内全部可退子项 profileTokens：指定 Profile（填iccid或esimTranNo）；省略则退该子项全部 Profile
响应 status：
| 值 | 含义 |
|---|---|
REFUNDED | 退款已入账 |
REFUNDING | 退款处理中，请轮询查单或等待 REFUND_COMPLETED Webhook（见 Webhook） |
子项 refundStatus：PENDING / COMPLETED。
建议
- 需要退钱给合作伙伴：使用
/esim/refund - 仅需取消 eSIM且已与用户线下结算：可使用
/esim/profile/cancel