最新更新时间：2020.03.18 版本说明
服务商可通过此接口添加分账接收方，建立分账接收方列表。连锁加盟模式下，服务商添加的分账接收方统一在品牌主商户号维度进行管理。
• 添加接收方成功后，后续通过发起分账请求，品牌主及门店可以直接向分账接收方列表中的接收方进行分账。
• 品牌主商户号，系统默认添加进入分账接收方列表，无需重复添加。
• 默认支持品牌主商户号向品牌下加盟的门店商户号进行分账，无需添加门店为分账接收方；上述条件需要品牌主商户号和门店商户号具有相同的服务商。其他门店需要参与分账的场景，仍需将门店商户号添加到分账接收方列表中
• 服务商需确保向微信支付传输用户身份信息和账号标识信息做一致性校验已合法征得用户授权
适用对象：服务商
请求URL：https://api.mch.weixin.qq.com/v3/brand/profitsharing/receivers/add
请求方式：POST
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 品牌主商户号 | brand_mchid | string[1,32] | 是 | body 品牌主商户号，即绑定具体品牌的商户号，填写微信支付分配的商户号。 示例值：1900000108 |
| 公众账号ID | appid | string[1,32] | 是 | body 微信分配的公众账号ID，这里指服务商的appid 示例值：wx8888888888888888 |
| 子商户公众账号ID | sub_appid | string[1,32] | 否 | body 微信分配的子商户公众账号ID，这里指品牌主的appid，分账接收方类型包含PERSONAL_SUB_OPENID时必填。 示例值：wx8888888888888889 |
| 分账接收方类型 | type | string[1,32] | 是 | body 枚举值： MERCHANT_ID：商户号（mch_id或者sub_mch_id） PERSONAL_OPENID：个人openid（由服务商的APPID转换得到） PERSONAL_SUB_OPENID：个人sub_openid（由品牌主的APPID转换得到） 示例值：MERCHANT_ID |
| 分账接收方账号 | account | string[1,64] | 是 | body 1、分账接收方类型为MERCHANT_ID时，分账接收方账号为商户号（mch_id或者sub_mch_id） 2、分账接收方类型为 PERSONAL_OPENID时，分账接收方账号为个人openid 3、分账接收方类型为 PERSONAL_SUB_OPENID时，分账接收方账号为个人sub_openid 示例值：1900000109 |
| 接收方名称 | name | string[1,256] | 否 | body 分账接收方的名称。 1、当type为MERCHANT_ID时，接收方名称必传，且为商户全称。 2、当type为PERSONAL_OPENID时，接收方名称选传，且为个人姓名。（传入该字段时需要进行校验。） 3、当type为PERSONAL_SUB_OPENID时，接收方名称选传，且为个人姓名。（传入该字段时需要进行校验。） 示例值：张三网络公司 |
| 与品牌主商户的关系类型 | relation_type | string[1,32] | 是 | body 子商户与接收方的关系。 枚举值： SUPPLIER：供应商 DISTRIBUTOR：分销商 SERVICE_PROVIDER：服务商 PLATFORM：平台 STAFF：员工 OTHERS：其他 示例值：SUPPLIER |
{
"brand_mchid": "1900000108",
"appid": "wx8888888888888888",
"sub_appid": "wx8888888888888889",
"type": "MERCHANT_ID",
"account": "1900000109",
"name": "张三网络公司",
"relation_type": "SUPPLIER"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 品牌主商户号 | brand_mchid | string[1,32] | 是 | 品牌主商户号，即绑定具体品牌的商户号，填写微信支付分配的商户号。 示例值：1900000108 |
| 分账接收方类型 | type | string[1,32] | 是 | 枚举值： MERCHANT_ID：商户号（mch_id或者sub_mch_id） PERSONAL_OPENID：个人openid（由服务商的APPID转换得到） PERSONAL_SUB_OPENID：个人sub_openid（由品牌主的APPID转换得到） 示例值：MERCHANT_ID |
| 分账接收方账号 | account | string[1,64] | 是 | 1、分账接收方类型为MERCHANT_ID时，分账接收方账号为商户号（mch_id或者sub_mch_id） 2、分账接收方类型为PERSONAL_OPENID时，分账接收方账号为个人openid 3、分账接收方类型为 PERSONAL_SUB_OPENID时，分账接收方账号为个人sub_openid 示例值：1900000109 |
{
"brand_mchid": "1900000108",
"type": "MERCHANT_ID",
"account": "1900000109"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 系统异常，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 请求参数不符合参数格式 | 请使用正确的参数重新调用 |
| 400 | INVALID_REQUEST | 无效请求 | 请确认分账接收方是否存在 |
| 403 | NO_AUTH | 商户无权限 | 请开通商户号分账权限 |
| 429 | FREQUENCY_LIMITED | 添加接收方频率过高 | 请降低频率后重试 |