API Changelog Bot 7bd8b1e737 changelog: 新增直接申诉退款接口

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

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-03-23 17:22:25 +08:00

2.2 KiB

原始文件 Blame 文件历史

新增：直接申诉退款接口

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

业务场景

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

新接口

直接申诉退款

POST /mp/order/refund/{orderId}/direct-appeal

请求体：

{
  "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 已改为必填（之前文档缺失，现已补充）

2.2 KiB 原始文件 Blame 文件历史 Unescape Escape