最新更新时间：2021.05.11 版本说明
商户发起添加分账接收方请求，建立分账接收方列表。后续可通过发起分账请求，将分账方商户结算后的资金，分到该分账接收方
• 商户需确保向微信支付传输用户身份信息和账号标识信息做一致性校验已合法征得用户授权
适用对象：直连商户
请求URL：https://api.mch.weixin.qq.com/v3/profitsharing/receivers/add
请求方式：POST
path 指该参数为路径参数
query 指该参数为URL参数
body 指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 应用ID | appid | string[1, 32] | 是 | body微信分配的公众账号ID 示例值：wx8888888888888888 |
| 分账接收方类型 | type | string[1, 32] | 是 | body枚举值： MERCHANT_ID：商户ID PERSONAL_OPENID：个人openid（由父商户APPID转换得到） 示例值：MERCHANT_ID |
| 分账接收方账号 | account | string[1, 64] | 是 | body类型是MERCHANT_ID时，是商户号 类型是PERSONAL_OPENID时，是个人openid openid获取方法 示例值：86693852 |
| 分账个人接收方姓名 | name | string[1, 1024] | 否 | body分账接收方类型是MERCHANT_ID时，是商户全称（必传），当商户是小微商户或个体户时，是开户人姓名 分账接收方类型是PERSONAL_OPENID时，是个人姓名（选传，传则校验） 1、此字段需要加密，加密方法详见：敏感信息加密说明 2、使用微信支付平台证书中的公钥：获取平台证书 3、使用RSAES-OAEP算法进行加密 4、将请求中HTTP头部的Wechatpay-Serial设置为证书序列号 示例值：hu89ohu89ohu89o |
| 与分账方的关系类型 | relation_type | string[1, 32] | 是 | body子商户与接收方的关系。 本字段值为枚举： STORE：门店 STAFF：员工 STORE_OWNER：店主 PARTNER：合作伙伴 HEADQUARTER：总部 BRAND：品牌方 DISTRIBUTOR：分销商 USER：用户 SUPPLIER： 供应商 CUSTOM：自定义 示例值：STORE |
| 自定义的分账关系 | custom_relation | string[1, 10] | 否 | body子商户与接收方具体的关系，本字段最多10个字。 当字段relation_type的值为CUSTOM时，本字段必填; 当字段relation_type的值不为CUSTOM时，本字段无需填写。 示例值：代理商 |
{
"appid": "wx8888888888888888",
"type": "MERCHANT_ID",
"account": "86693852",
"name": "hu89ohu89ohu89o",
"relation_type": "STORE",
"custom_relation": "代理商"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 分账接收方类型 | type | string[1, 32] | 是 | 枚举值： MERCHANT_ID：商户ID PERSONAL_OPENID：个人openid（由父商户APPID转换得到） 示例值：MERCHANT_ID |
| 分账接收方账号 | account | string[1, 64] | 是 | 类型是MERCHANT_ID时，是商户号 类型是PERSONAL_OPENID时，是个人openid openid获取方法 示例值：86693852 |
| 分账个人接收方姓名 | name | string[1, 1024] | 否 | 分账接收方类型是MERCHANT_ID时，是商户全称（必传），当商户是小微商户或个体户时，是开户人姓名 分账接收方类型是PERSONAL_OPENID时，是个人姓名（选传，传则校验） 1、此字段需要加密，加密方法详见：敏感信息加密说明 2、使用微信支付平台证书中的公钥：获取平台证书 3、使用RSAES-OAEP算法进行加密 4、将请求中HTTP头部的Wechatpay-Serial设置为证书序列号 示例值：hu89ohu89ohu89o |
| 与分账方的关系类型 | relation_type | string[1, 32] | 是 | 商户与接收方的关系。本字段值为枚举： STORE：门店 STAFF：员工 STORE_OWNER：店主 PARTNER：合作伙伴 HEADQUARTER：总部 BRAND：品牌方 DISTRIBUTOR：分销商 USER：用户 SUPPLIER： 供应商 CUSTOM：自定义 示例值：STORE |
| 自定义的分账关系 | custom_relation | string[1, 10] | 否 | 子商户与接收方具体的关系，本字段最多10个字。 当字段relation_type的值为CUSTOM时，本字段必填; 当字段relation_type的值不为CUSTOM时，本字段无需填写。 示例值：代理商 |
{
"type": "MERCHANT_ID",
"account": "86693852",
"name": "hu89ohu89ohu89o",
"relation_type": "STORE"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 系统异常，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 请求参数不符合参数格式 | 请使用正确的参数重新调用 |
| 400 | INVALID_REQUEST | 无效请求 | 请确认分账接收方是否存在 |
| 403 | NO_AUTH | 商户无权限 | 请开通商户号分账权限 |
| 429 | RATELIMIT_EXCEED | 添加接收方频率过高 | 请降低频率后重试 |