hl-api-changelog/changelogs/2026-03/27_1832_refund_policy_text.md
API Changelog Bot 4220578991 fix: 小程序退款政策返回规则文字 (PR #26)
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-27 18:32:44 +08:00

1.6 KiB

小程序产品详情:退款政策返回规则文字

日期: 2026-03-27 类型: BUG修复 影响服务: hl-product-service 影响接口: GET /mp/product/{productId}


变更说明

产品详情接口新增 refundPolicies 字段,按支付类型分组返回退款政策的名称和规则文字。

原有的 refundPolicyIds 字段保持不变(后台管理用)。

新增字段

refundPolicies

字段 类型 说明
refundPolicies Map<String, List> key=支付类型(FULL/DEPOSIT/BALANCE),value=政策列表
└ policyName String 政策名称
└ rules List 规则文字列表

响应示例(新增部分)

{
  "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 列表