Documentation

外部 Halo 商城：对接规则、发放与认领

外部 Halo 商城：对接规则、发放与认领

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

用途与准备

外部商城对接把外部购买结果映射为本站产品权益。管理员需要外部商品 ID、规格 ID、内部产品 Key、价格策略以及所需履约动作。

配置规则

  1. 进入控制台 Halo 商城对接规则，创建并填写外部商品、规格标识。
  2. 选择本站产品和价格策略。
  3. 选择履约动作，补齐动作需要的字段。
  4. 选择响应来源，保存启用。
  5. 按对接协议调用发放流程，核对 Halo 商城发放记录和实际形成权益。
动作结果
CREATE_ORDER创建内部订单记录
CREATE_AUTH_PLACEHOLDER创建等待用户绑定的授权占位
CREATE_COUPON按模板创建优惠券权益

优惠券动作需要有效模板。响应来源与实际动作应匹配，避免外部页面拿到与预期不同的权益信息。

接口与用户认领

发放入口为 POST /apis/public.product.muyin.site/v1alpha1/mall-fulfillment/issue。完整字段、认证条件和响应应按接入双方协议核对，不能把主题公开访问令牌当成通用写入凭据。

外部购买后，用户登录本站，在 /uc/product 的商城认领输入商城回调返回的权益 code，解析可认领权益并确认绑定。授权类权益要求域名时，还需填写授权域名。认领成功后到我的订单、授权数据或优惠数据核对结果，并检查目标域名授权。

验收

核对外部订单标识、商品与规格、购买用户、本站产品、履约记录及最终权益。发生回调或网络异常时先查询原发放记录，确认已有结果再按协议处理，避免把未知结果直接当作未发放。

排障

没有匹配规则时检查商品和规格标识；创建优惠券失败时检查模板；无法认领时检查权益 code、授权域名、已有归属和认领状态；发放异常优先查看 Halo 商城发放记录。

相关文档

评论