加载中…

合伙人 / 团队长二级分销插件使用教程

本插件实现一套**两级返佣**体系,规则很简单: + **会员**消费后 → **团队长**和**合伙人**获得返佣; + **团队长**消费后 → **合伙人**获得返佣。 角色关系一览: ```plain 合伙人 └── 团队长(可付费升级成为) └── 团队成员(绑定团队长后加入) ``` ![](https://dcdn.it120.cc/yuque/0/2021/png/572726/1611394969316-3cacb470-7e7c-4609-acd7-18fa1f08bb37.png) ## 第一步:分销设置 ![](https://dcdn.it120.cc/yuque/0/2026/png/572726/1795165895931-c305cafe-a8dc-4ca0-b61f-ac510041232c.png) 在后台分销设置中,配置以下内容: | 设置项 | 说明 | | --- | --- | | 合伙人返佣比例 | 合伙人从消费中获得的返佣比例 | | 团队长返佣比例 | 团队长从团队成员消费中获得的返佣比例 | | 团队长购买价格 | 团队成员付费升级为团队长的费用 | | 团队长自动绑定会员等级 | 升级为团队长后自动绑定该等级,享受对应会员价购买商品 | | 团队成员自动绑定会员等级 | 成为团队成员后自动绑定该等级,享受对应会员价购买商品 | > 📷 配图建议:后台分销设置界面截图 > ## 第二步:添加 / 管理合伙人 **合伙人只能在后台添加**,目前支持**个人 / 企业**两种身份类型。后台添加后,该用户即获得合伙人权限。 ## 前端开发:相关接口一览 前端需要做的展示与交互,对应以下 5 个接口: | 接口 | 用途 | | --- | --- | | 读取分销设置 | 读取设置信息,前端按需展示 | | 绑定团队长 | 用户绑定后成为该团队长的团队成员,之后消费时团队长和合伙人获得佣金 | | 购买升级为团队长 | 团队成员自助升级,赚取佣金 | | 名下团队成员人数统计 | 读取名下团队长人数、团队成员人数 | | 团队列表 | 读取团队长及团队人数列表 | ## apifm-wxapi SDK 调用详解 SDK 文档:[https://www.it120.cc/sdk/index.html](https://www.it120.cc/sdk/index.html) ### 1. 读取合伙人分销设置 ```javascript WXAPI.partnerSetting() ``` 返回字段说明: | 字段 | 含义 | | --- | --- | | `isOpen` | 功能是否开启 | | `pPartner` | 合伙人返佣比例 | | `pLeader` | 团队长返佣比例 | | `priceLeader` | 团队长购买费用(可购买升级) | | `leaderUserLevelId` | 升级为团队长后自动绑定的会员等级 | | `memberUserLevelId` | 升级为团队成员后自动绑定的会员等级 | ### 2. 用户绑定团队长,成为团队成员 ```javascript WXAPI.partnerBindTeamLeader(token, uid) ``` + `uid` 为**团队长的用户编号**; + 绑定后,用户即加入该团队长所在的团队。 ### 3. 团队成员购买升级为团队长 ```javascript WXAPI.partnerBuyTeamLeader(token) ``` + 购买成功后,**立即成为团队长**; + 本接口使用**用户余额**购买。如希望用**微信支付**购买,请参考微信支付接口,通过设置 `nextAction` 实现在线支付购买团队长。 ### 4. 团队成员统计 ```javascript WXAPI.partnerMembersStatistics(token) ``` 返回字段: + `leaders`:名下团队长的数量(针对合伙人身份) + `members`:名下团队成员的数量 返回示例: ```json { "code": 0, "data": { "members": 0, "leaders": 0 }, "msg": "success" } ``` ### 5. 团队成员列表 ```javascript WXAPI.partnerMembers(Object object) ``` 返回数据示例: ```json { "code": 0, "data": { "result": [ { "nick": "刘备", "uid": 1811002, "avatarUrl": "https://thirdwx.qlogo.cn/mmopen/vi_32/DYAIOgq83eo0wTd9Ys8tQG6PMrYuPkQ8cYAH8mDiaEyEygpStdABiaSicUM5y8VQicMwHkB8qKj5dJ1PI8O6ia8dWBA/132" } ], "totalRow": 1, "statisticsCommisionMap": { "1811002": { "amount": 999, "day": "2021", "id": 25883, "number": 888, "saleroom": 0 } }, "totalPage": 1 }, "msg": "success" } ``` ## 小结 > 后台设好两级返佣比例和会员等级绑定 → 后台添加合伙人 → 前端用 5 个 SDK 接口完成"读设置、绑团队、买升级、看统计、看列表",即可跑通合伙人 / 团队长二级分销。 >