文档：退款原因管理补 reason/list 列表端点（PR #4243，Issue #4242）

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<RefundReasonVO>，字段详见第 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 路径为新基线。