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