# 新增：直接申诉退款接口

**日期**: 2026-03-23
**模块**: C端退款

---

## 业务场景

用户查看退款预览 → 对系统计算的退款金额不满意 → 跳过退款申请，直接发起申诉填写期望金额。

## 新接口

### 直接申诉退款
```
POST /mp/order/refund/{orderId}/direct-appeal
```

**请求体**：
```json
{
  "appealReason": "退款金额不合理，要求全额退款",   // 必填
  "appealAmount": 5700.00,                         // 必填，期望退款金额（不能超过已付金额）
  "evidence": ["https://oss.../proof1.jpg"]         // 选填，凭证图片列表（最多9张）
}
```

**响应**：返回退款申请详情（状态为 APPEALING）

**校验规则**：
- `appealAmount` 必填，必须 > 0，**不能超过已付金额**
- 订单必须在可退款状态（DEPOSIT_PAID/PAID/CONFIRMED/PENDING_BALANCE/PENDING_DEPARTURE）
- 不能重复提交（已有进行中的退款申请时拒绝）

## 退款流程（完整）

```
用户操作退款 → 查看退款预览（GET /mp/order/refund/{orderId}/refund-preview）
  ├── 满意 → 提交退款申请（POST /mp/order/refund/{orderId}/refund） → 等待审批
  └── 不满意 → 直接申诉（POST /mp/order/refund/{orderId}/direct-appeal） → 企微OA审批
```

## 页面交互建议

退款预览页底部：
```
┌────────────────────────────────┐
│ 系统计算退款金额: ¥3,000.00     │
│ 退款比例: 60%（出发前3天）       │
│                                │
│  [申请退款]    [不满意？直接申诉] │
└────────────────────────────────┘
```

点击"直接申诉" → 弹窗/页面填写期望金额+申诉原因+上传凭证 → 提交

## 已有接口（无变化）

- `GET /mp/order/refund/{orderId}/refund-preview` — 退款金额预览
- `POST /mp/order/refund/{orderId}/refund` — 提交退款申请
- `POST /mp/order/refund/refund/{applicationId}/appeal` — 退款被拒后申诉
- `GET /mp/order/refund/{orderId}/refund-detail` — 退款详情

## MpRefundAppealRequest 字段更新

`appealAmount` 已改为**必填**（之前文档缺失，现已补充）
