Documentation

支付插件与会员能力接入

支付插件与会员能力接入

适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。

依赖与职责

支付宝、微信渠道由支付插件提供；余额与积分通过会员插件统一交易接口处理。当前产品插件声明可选依赖 PluginPayment >=3.0.0、PluginMember >=1.3.0，使用能力前需启用对应插件。

配置渠道支付

  1. 在支付插件准备可用的支付宝或微信支付渠道。
  2. 打开产品插件支付设置，开启支付并选择相应渠道。
  3. 配置订单同步任务和支付返回页。
  4. 使用低金额业务样例检查实际渠道付款、订单状态及回跳。

配置余额和积分

  1. 在会员插件的插件统一接入中启用接入，为 PluginProduct 分配独立服务令牌。
  2. 在产品插件会员能力接入中开启能力，填写 Halo 站点根地址和同一服务令牌；地址不要带 /apis 后缀。
  3. 在支付设置选择会员余额或会员积分渠道。
  4. 积分支付配置换算比例，表示每 1 元订单金额消耗的积分，例如 10 表示 19.9 元消耗 199 积分。
  5. 保存后使用页面的会员统一接口预检。管理员接口为：
POST /apis/console.product.muyin.site/v1alpha1/member-integration/self-check

确认响应识别的插件为 PluginProduct，再进行余额或积分业务验证。

交易与未知结果

产品服务端调用会员交易接口 /apis/public.member.muyin.site/v1alpha1/integration/transactions，携带 X-Muyin-Member-Token。令牌只用于服务端，不应下发给浏览器、主题或普通用户。

请求 ID 由持久化订单 ID 与支付动作确定。网络中断或可恢复服务错误时保留待确认订单，按原幂等键同步。400/401/403/404/409 等明确错误应核对权限和业务原因，不通过换请求 ID 重复扣减。成功的会员流水 ID 保存到订单支付信息中。

停用与验收

停用会员交易时，先关闭余额和积分支付渠道，再关闭会员能力接入，保留待确认订单供后续核对。服务预检、真实扣减、订单同步和交付结果分别检查；推荐码与会员折扣还需独立验证优惠配置。

相关文档

评论