From 7bd8b1e73763ed0c91d8ac66963df4bdbbc9636f Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Mon, 23 Mar 2026 17:22:25 +0800
Subject: [PATCH] =?UTF-8?q?changelog:=20=E6=96=B0=E5=A2=9E=E7=9B=B4?=
 =?UTF-8?q?=E6=8E=A5=E7=94=B3=E8=AF=89=E9=80=80=E6=AC=BE=E6=8E=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

POST /mp/order/refund/{orderId}/direct-appeal
用户对退款政策金额不满意可跳过退款申请直接申诉，申诉金额不能超过已付金额。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 .../2026-03/2026-03-23_direct_appeal_api.md   | 66 +++++++++++++++++++
 1 file changed, 66 insertions(+)
 create mode 100644 changelogs/2026-03/2026-03-23_direct_appeal_api.md

diff --git a/changelogs/2026-03/2026-03-23_direct_appeal_api.md b/changelogs/2026-03/2026-03-23_direct_appeal_api.md
new file mode 100644
index 0000000..a6f5678
--- /dev/null
+++ b/changelogs/2026-03/2026-03-23_direct_appeal_api.md
@@ -0,0 +1,66 @@
+# 新增：直接申诉退款接口
+
+**日期**: 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` 已改为**必填**（之前文档缺失，现已补充）