金额与积分口径冻结

概述

为避免“页面展示字段 / 接口字段 / 数据对象字段”之间出现口径漂移，需统一金额与积分相关字段定义，并冻结使用口径。

金额字段口径

• goodsAmount：商品金额，不含运费。
  • 纯积分订单下，该字段可为 0，或按现金等价展示。
  • 不得参与实际扣款。
• freightAmount：运费金额。
• totalAmount：应付总金额（现金口径）。
  • 定义：totalAmount = goodsAmount + freightAmount
• cashAmount：实际支付现金金额，与 payType 相关。
  • payType=wechat：cashAmount = totalAmount
  • payType=mix：cashAmount > 0，同时存在积分扣减
  • payType=points：cashAmount = 0

积分字段口径

• pointsAmount：实际扣减积分。
  • 以支付成功后落账的积分数为准。
• pointsFrozenAmount：冻结积分。
  • 指下单成功后、支付完成前的冻结积分数。
  • 支付成功后应转为 pointsAmount，或在未完成支付时被释放。

积分余额口径

与 6.3 / 7.8 保持一致：

• totalBalance = availableBalance + frozenBalance
• availableBalance：可用余额，可用于抽奖 / 下单。
• frozenBalance：冻结余额，不可用于抽奖 / 下单。

使用约束

• 页面展示、接口返回、数据对象存储必须遵循同一口径。
• 纯积分订单中，goodsAmount 即使展示为现金等价值，也不能作为实际现金扣款依据。
• 积分支付链路中，应明确区分“冻结积分”与“实际扣减积分”，避免状态混用。