# 注册推客以及带货机构绑定推客

相关文档
- [获取推客的注册状态以及和机构的绑定状态](/doc/store/leagueheadsupplier/api/sharer/account/api_getpromoterregisterandbindstatus)
- [推客绑定机构的回调](/doc/store/leagueheadsupplier/callback/promoter_bind_event)

## 接口名称：wx.openBusinessView

开发者可通过调用 wx.openBusinessView 方式在小程序进行注册推客操作以及带货机构绑定推客的操作。

### 注册推客

1. 调用 [获取推客的注册状态以及和机构的绑定状态](/doc/store/leagueheadsupplier/api/sharer/account/api_getpromoterregisterandbindstatus) 查询推客注册状态， `register_status 值为 0 或者 1` 则需要进行注册推客的操作，记录 `register_business_type`、`register_query_string` 在下一步使用；
2. 小程序调用 `wx.openBusinessView` 注册推客，`businessType`、`queryString` 的值为上一步返回的 `register_business_type`、`register_query_string`；
3. 调用 [获取推客的注册状态以及和机构的绑定状态](/doc/store/leagueheadsupplier/api/sharer/account/api_getpromoterregisterandbindstatus)  查询推客注册状态， `register_status 值为 2`  表示已完成推客注册；

### 带货机构绑定推客

1. 调用 [获取推客的注册状态以及和机构的绑定状态](/doc/store/leagueheadsupplier/api/sharer/account/api_getpromoterregisterandbindstatus) 查询推客注册状态以及和机构的绑定状态， `register_status 值为 2` 且 `bind_status 值为 0`，则需要进行绑定推客的操作，记录 `bind_business_type`、`bind_query_string` 在下一步使用；
2. 小程序调用 `wx.openBusinessView` 绑定推客，`businessType`、`queryString` 的值为上一步返回的 `bind_business_type`、`bind_query_string`；
3. 调用 [获取推客的注册状态以及和机构的绑定状态](/doc/store/leagueheadsupplier/api/sharer/account/api_getpromoterregisterandbindstatus) 查询推客注册状态以及和机构的绑定状态， `bind_status 值为 1`  表示已完成和机构的绑定；

## 请求参数说明

### Object object

| 参数名 | 变量 | 类型 | 必填|描述|
| :-- | :-- | :-- | :-- | :-- |
|跳转类型	|businessType	|string	| 是	|  调用 [获取推客的注册状态以及和机构的绑定状态](/doc/store/leagueheadsupplier/api/sharer/account/api_getpromoterregisterandbindstatus) 返回的   register_business_type（注册推客） 或者 bind_business_type（绑定推客）的值 |
|业务参数	| queryString	| string	| 是	| 调用 [获取推客的注册状态以及和机构的绑定状态](/doc/store/leagueheadsupplier/api/sharer/account/api_getpromoterregisterandbindstatus) 返回的   register_query_string（注册推客） 或者 bind_query_string（绑定推客）的值  |
|业务参数	|extraData	|Object<ExtraData>	|是	|  |

### ExtraData

| 属性 | 类型 | 必填|描述|
| :-- | :-- | :-- | :-- |
|commissionType	| number	 | 是	| 分佣类型，0代表平台分佣，1代表机构自己分佣 |
|commissionRatio	| number	| 是	| 分佣比例，如果为平台分佣，值的范围为 100000 - 1000000，代表了【10%，100%】，如果是机构自己分佣，设置成 1 就好|
|headSupplierAppid	|string	|是	| 带货机构 appid |

## 组件回调

用户进行操作后，组件通过 wx.navigateBackMiniProgram 回调小程序，开发者可以在`App.onShow` 通过[获取推客的注册状态以及和机构的绑定状态](/doc/store/leagueheadsupplier/api/sharer/account/api_getpromoterregisterandbindstatus) 重新查询推客的注册状态和绑定状态。

## 示例代码

```js
if (wx.openBusinessView) {
  wx.openBusinessView({
    businessType: 'CreatorApplyments',
    queryString: '',
    extraData: ｛
      commissionType: 0, // 平台分佣 
      commissionRatio: 100000, //  分佣比例10%
      headSupplierAppid： 'your appid' // 你的带货机构appid
    }
  }),
  success() {
    //dosomething
  },
  fail() {
    //dosomething
  },
  complete() {
    //dosomething
    }
  });
} else {
  //引导用户升级微信版本
}
```

## 接口兼容

- 小程序版本库 >= 2.6.0，低版本需提示用户升级微信版本。
- iOS兼容性：兼容IOS 8.0.30.34 及以上版本。
- Android兼容性：兼容 安卓 8.0.30  及以上版本。

![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)文档变更日志（1条）
2026 年 01 月 21 日文档描述优化