changelog: 新增直接申诉退款接口
POST /mp/order/refund/{orderId}/direct-appeal
用户对退款政策金额不满意可跳过退款申请直接申诉,申诉金额不能超过已付金额。
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
这个提交包含在:
父节点
3106474891
当前提交
7bd8b1e737
@ -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` 已改为**必填**(之前文档缺失,现已补充)
|
||||||
正在加载...
x
在新工单中引用
屏蔽一个用户