# 设置自定义分账比例
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
SetCustomShareRatio
# 功能描述
该 API 用于服务商针对单个小程序设置个性化的广告收入分账的比例。使用过程中如遇到问题,可在开放平台服务商专区交流专区 | 微信开放社区发帖交流。
# 注意事项
1、其中access_token为component_access_token
2、服务商通过接口设置/更改分账比例,不代表比例生效;需要由商家在权限集授权流程中进行确认,才视为实际生效。
3、具体授权发起流程可以参考链接:更新授权
4、商家实际生效的分账比例,可以通过查询分账比例接口进行查询
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/setdefaultamsinfo?action=agency_set_custom_share_ratio&access_token=xxxxxxxxxxxxxxx
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
share_ratio | number | 是 | 服务商自定义分账比例。签约时,默认优先使用自定义分账比例,若不存在,则使用默认分账比例。如share_ratio为40,则代表服务商获得收益的40%,小程序商家获得收益的60% |
appid | string | 是 | 针对该小程序APPID设置自定义分账比例。 |
# 返回参数
属性 | 类型 | 说明 |
---|---|---|
ret | number | 错误码 |
err_msg | string | 错误信息 |
# 调用示例
示例说明: HTTPS请求
# 请求数据示例
{
"appid": "wxf3dsfsfsdf478",
"share_ratio" : 50
}
# 返回数据示例
{
"ret": 0,
"err_msg":""
}
# 错误码
错误码 | 错误码取值 | 解决方案 |
---|---|---|
0 | ok | ok |
-202 | 内部错误 | 可在一段时间后重试 |
1700 | 参数错误 | 检验输入参数是否符合文档说明 |
1701 | 参数错误 | 检验输入参数是否符合文档说明 |
1737 | 操作过快 | 等待一分钟后重新操作 |
2056 | 服务商未在变现专区开通账户 | 在第三方平台页面的变现专区开通服务 |