From ee75e0ca36e20a28b71b4667fef245aad5d74683 Mon Sep 17 00:00:00 2001 From: yaosutu <770858045@qq.com> Date: Mon, 22 Jun 2026 16:35:50 +0800 Subject: [PATCH] =?UTF-8?q?=E6=96=87=E6=A1=A3=EF=BC=9A=E9=80=80=E6=AC=BE?= =?UTF-8?q?=E5=8E=9F=E5=9B=A0=E7=AE=A1=E7=90=86=E8=A1=A5=20reason/list=20?= =?UTF-8?q?=E5=88=97=E8=A1=A8=E7=AB=AF=E7=82=B9=EF=BC=88PR=20#4243?= =?UTF-8?q?=EF=BC=8CIssue=20#4242=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...ason_退款政策与原因管理-新增接口-管理后台.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/changelogs-v2/2026-06/22_refund-policy-reason_退款政策与原因管理-新增接口-管理后台.md b/changelogs-v2/2026-06/22_refund-policy-reason_退款政策与原因管理-新增接口-管理后台.md index 1a432ad..95e7eed 100644 --- a/changelogs-v2/2026-06/22_refund-policy-reason_退款政策与原因管理-新增接口-管理后台.md +++ b/changelogs-v2/2026-06/22_refund-policy-reason_退款政策与原因管理-新增接口-管理后台.md @@ -21,6 +21,7 @@ |------|------| | 路径变更 | 退款政策 7 个端点：/admin/order/refund-policy/* 统一升为 /v3/admin/order/refund-policy/* | | 路径变更 | 退款原因 3 个端点：/admin/order/refund-policy/reason/* 统一升为 /v3/admin/order/refund-policy/reason/* | +| 新增端点 | 补 reason/list 列表端点（PR #4243），返回全量退款原因含禁用 | | 无字段变更 | 入参/出参/枚举全部与 v2 一致 | | 算法差异 | 退款金额计算：v3 区间判定与舍入方式与 v2 不同（详见第 12 节） | @@ -35,6 +36,21 @@ --- +### 退款原因管理端点清单 + +| 方法 | 路径 | 用途 | +|------|------|------| +| GET | /v3/admin/order/refund-policy/reason/list | 退款原因列表（含禁用，按 sortOrder 升序，供管理后台维护） | +| POST | /v3/admin/order/refund-policy/reason | 创建退款原因 | +| PUT | /v3/admin/order/refund-policy/reason/{reasonId} | 修改退款原因 | +| DELETE | /v3/admin/order/refund-policy/reason/{reasonId} | 软删除退款原因 | + +> GET reason/list 返回 List，字段详见第 5 节。与 C 端区别：admin 接口调用 listReasons(false) 返回全量含禁用；C 端 GET /v3/internal/mp/order/refund/reasons 只返启用项（listReasons(true)）。 +> +> 出参示例： +> + + ## 4. 入参 ### 4.1 路径参数 / Query 参数 @@ -200,6 +216,7 @@ | 创建退款原因 | POST /admin/order/refund-policy/reason | POST /v3/admin/order/refund-policy/reason | 无 | | 修改退款原因 | PUT /admin/order/refund-policy/reason/{reasonId} | PUT /v3/admin/order/refund-policy/reason/{reasonId} | 无 | | 删除退款原因 | DELETE /admin/order/refund-policy/reason/{reasonId} | DELETE /v3/admin/order/refund-policy/reason/{reasonId} | 无 | +| 退款原因列表（含禁用） | GET /admin/order/refund-policy/reason/list | GET /v3/admin/order/refund-policy/reason/list | 无；admin 返回全量含禁用，C 端 /internal/mp/order/refund/reasons 只返启用 | v2 旧路径在 v2 服务下线后返回 404，v3 路径为新基线。