合伙人 / 团队长二级分销插件使用教程
帮助文档
随时更新
本插件实现一套**两级返佣**体系,规则很简单:
+ **会员**消费后 → **团队长**和**合伙人**获得返佣;
+ **团队长**消费后 → **合伙人**获得返佣。
角色关系一览:
```plain
合伙人
└── 团队长(可付费升级成为)
└── 团队成员(绑定团队长后加入)
```

## 第一步:分销设置

在后台分销设置中,配置以下内容:
| 设置项 | 说明 |
| --- | --- |
| 合伙人返佣比例 | 合伙人从消费中获得的返佣比例 |
| 团队长返佣比例 | 团队长从团队成员消费中获得的返佣比例 |
| 团队长购买价格 | 团队成员付费升级为团队长的费用 |
| 团队长自动绑定会员等级 | 升级为团队长后自动绑定该等级,享受对应会员价购买商品 |
| 团队成员自动绑定会员等级 | 成为团队成员后自动绑定该等级,享受对应会员价购买商品 |
> 📷 配图建议:后台分销设置界面截图
>
## 第二步:添加 / 管理合伙人
**合伙人只能在后台添加**,目前支持**个人 / 企业**两种身份类型。后台添加后,该用户即获得合伙人权限。
## 前端开发:相关接口一览
前端需要做的展示与交互,对应以下 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 接口完成"读设置、绑团队、买升级、看统计、看列表",即可跑通合伙人 / 团队长二级分销。
>