# 获取推客的注册状态以及和机构的绑定状态
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:getpromoterregisterandbindstatus
可通过该接口,可获取到当前推客,在推客平台上的注册状态,以及和当前机构的绑定状态
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/promoter/get_promoter_register_and_bind_status?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 示例 | 说明 |
---|---|---|---|---|
access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
sharer_openid | string | 否 | 推客在小程序中的 openid, 必须是机构绑定小程序的用户openid,而不能是其他小程序的用户openid。 和 sharer_appid 二选一 |
sharer_appid | string | 否 | 推客在微信电商平台注册的身份标识,和 sharer_openid 二选一 |
is_simple_register | boolean | 是 | 是否走简易版本注册【当走简易版本注册时,可以不要求推客开通商户号,但分佣只能走机构自己分佣;如果不走简易注册流程时,要求推客开通商户号作为收款账户,可以平台分佣】 |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
bind_status | number | 和机构的绑定状态,0:未绑定 1:已绑定 |
register_status | number | 当前推客的注册状态:0:未注册 1:注册中,还未完成 2:已完成注册 3:用户未支付实名,需要把微信先支付实名才能继续注册 |
register_business_type | string | register_status等于 0 或者 1时,调用注册流程时,openBusinessView需要的businessType |
register_query_string | string | 注册时需要的queryString参数 |
bind_business_type | string | bind_status等于0时,调用绑定流程时,openBusinessView需要的businessType |
bind_query_string | string | 绑定时需要的queryString参数 |
sharer_appid | string | 如果推客和机构已经绑定,就返回对应推客的 appid |
# 4. 注意事项
调用openbusinesstype为注册时的示例:
headSupplierAppid为机构的appid内容 commissionType为分佣类型,0代表平台分佣,1代表机构自己分佣 commissionRatio为分佣比例,如果为平台分佣,值的范围为 100000 - 900000,代表了【10%,90%】,如果是机构自己分佣,设置成 0 就好
wx.openBusinessView(
{
businessType: 'CreatorApplyments',
queryString: '',
extraData: {
commissionType: number,
commissionRatio: number,
headSupplierAppid: xxx
}
}
)
调用openbusinesstype为绑定时的示例:
headSupplierAppid为机构的appid内容 commissionType为分佣类型,0代表平台分佣,1代表机构自己分佣 commissionRatio为分佣比例,如果为平台分佣,值的范围为 100000 - 900000,代表了【10%,90%】,如果是机构自己分佣,设置成 0 就好
wx.openBusinessView(
{
businessType: 'CreatorApplyments',
queryString: '',
extraData: {
commissionType: number,
commissionRatio: number,
headSupplierAppid: xxx
}
}
)
# 5. 代码示例
请求示例
{
"sharer_openid": "openid",
"is_simple_register": true
}
返回示例
{
"errcode": "0",
"errmsg": "ok",
"bind_status": 0,
"register_status":1,
"register_business_type":"",
"register_query_string":"",
"bind_business_type":"",
"bind_query_string":""
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
10024000 | 参数错误 | |
10071056 | 请求参数(如sharer_openid)对应的小程序未绑定到当前机构 |
# 7. 适用范围
本接口暂未明确可调用账号类型,或在业务中根据调用传参自行确定是否可调用,请已实际调用情况为准。