产品插件积分兑换与余额消费

适用版本:会员插件 1.3.3 · 核对日期:2026-10-10

用途

区分会员账户与产品订单职责,让商品、授权、实物或卡密业务通过产品插件完成订单和履约。

前置条件

产品插件与会员插件已按各自版本要求安装。调用方已完成会员统一接入配置;积分兑换要求账户积分足够,余额消费还要求余额账户开启。

操作入口

商品配置和订单流程位于产品插件文档;会员插件设置位于“插件接入”。

操作步骤

  1. 在产品插件配置商品或权益及允许的支付方式,不在会员插件另建商品库存。
  2. 配置产品调用方的独立服务令牌,使用统一交易接口完成账户扣减。
  3. 积分订单记录积分支付,会员插件记录 SCORE_PRODUCT_REDEMPTION 类流水;余额路径记录相应余额消费。
  4. 调用方以稳定业务请求 ID 核对账户结果后,继续自身订单和履约流程。
  5. 同时核对会员流水、产品订单状态以及实际授权、发货或卡密结果。

预期结果与核对

会员账户变更能关联产品业务 ID;商品库存、订单状态和交付由产品插件维护。

限制与注意事项

积分兑换商品不经过余额账户,也不等于积分划转。扣款完成不代表发货、授权或卡密交付成功;退款/补偿也必须由调用方按业务事实设计并核对,会员插件不提供跨插件分布式事务。

常见问题

  • 扣分了但没拿到商品? 先查原订单和履约错误,不能换请求 ID 重复扣分。
  • 能否只调用会员接口就生成商品订单? 不可以,账户接口不创建商品或订单。
  • 旧产品专用接口还能用吗? 代码保留部分兼容路径,新接入使用统一契约。