diff --git a/changelogs/2026-03/27_1832_refund_policy_text.md b/changelogs/2026-03/27_1832_refund_policy_text.md new file mode 100644 index 0000000..79bce18 --- /dev/null +++ b/changelogs/2026-03/27_1832_refund_policy_text.md @@ -0,0 +1,63 @@ +# 小程序产品详情:退款政策返回规则文字 + +**日期**: 2026-03-27 +**类型**: BUG修复 +**影响服务**: hl-product-service +**影响接口**: `GET /mp/product/{productId}` + +--- + +## 变更说明 + +产品详情接口新增 `refundPolicies` 字段,按支付类型分组返回退款政策的名称和规则文字。 + +原有的 `refundPolicyIds` 字段保持不变(后台管理用)。 + +## 新增字段 + +### refundPolicies + +| 字段 | 类型 | 说明 | +|------|------|------| +| refundPolicies | Map | key=支付类型(FULL/DEPOSIT/BALANCE),value=政策列表 | +| └ policyName | String | 政策名称 | +| └ rules | List | 规则文字列表 | + +### 响应示例(新增部分) + +```json +{ + "refundPolicyIds": { + "DEPOSIT": "1,3,4", + "BALANCE": "1,3,4" + }, + "refundPolicies": { + "DEPOSIT": [ + { + "policyName": "标准退款政策", + "rules": [ + "出发前7天及以上取消,全额退款", + "出发前3天及以上取消,退款50%", + "出发当天取消,不予退款" + ] + } + ], + "BALANCE": [ + { + "policyName": "标准退款政策", + "rules": [ + "出发前7天及以上取消,全额退款", + "出发前3天及以上取消,退款50%", + "出发当天取消,不予退款" + ] + } + ] + } +} +``` + +## 前端使用建议 + +小程序产品详情页「取消政策」部分,直接遍历 `refundPolicies` 展示: +- 按支付类型分区(如"定金退款政策"、"尾款退款政策") +- 每个政策显示 `policyName` 标题 + `rules` 列表