最新更新时间：2020.04.30 版本说明
1. 电商平台可通过此接口添加分账接收方，建立分账接收方列表（最多可添加20000个分账接收方）。后续通过发起分账请求，将电商平台下的二级商户结算后的资金，分给分账接收方列表中具体的分账接收方。
2. 添加的分账接收方统一都在电商平台维度进行管理，其他二级商户，均可向该分账接收方列表中的接收方进行分账，避免在二级商户维度重复维护。
• 电商平台需确保向微信支付传输用户身份信息和账号标识信息做一致性校验已合法征得用户授权。
适用对象：电商平台
请求URL：https://api.mch.weixin.qq.com/v3/ecommerce/profitsharing/receivers/add
请求方式：POST
path指该参数为路径参数
query指该参数需在请求URL传参
body指该参数需在请求JSON传参
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 公众账号ID | appid | string[1,32] | 是 | body 电商平台的appid（公众号APPID或者小程序APPID） 示例值：wx8888888888888888 |
| 接收方类型 | type | string[1,32] | 是 | body 分账接收方的类型，枚举值： MERCHANT_ID：商户 PERSONAL_OPENID：个人 示例值：MERCHANT_ID |
| 接收方账号 | account | string[1,64] | 是 | body 分账接收方的账号 类型是MERCHANT_ID时，是商户号 类型是PERSONAL_OPENID时，是个人openid，openid获取方法 示例值：190001001 |
| 接收方名称 | name | string[1,256] | 条件选填 | body 分账接收方的名称，当type为MERCHANT_ID时，接收方名称是商户全称。 示例值：张三网络公司 |
| 接收方名称的密文 | encrypted_name | string[1,10240] | 否 | body
1、分账接收方类型是PERSONAL_OPENID时，是个人姓名的密文（选传，传则校验） 此字段的加密的方式为： 2、使用微信支付平台证书中的公钥 3、使用RSAES-OAEP算法进行加密 4、将请求中HTTP头部的Wechatpay-Serial设置为证书序列号 字段加密: 使用APIv3定义的方式加密 示例值：hu89ohu89ohu89o |
| 与分账方的关系类型 | relation_type | string[1,32] | 是 | body 子商户与接收方的关系。 枚举值： SUPPLIER：供应商 DISTRIBUTOR：分销商 SERVICE_PROVIDER：服务商 PLATFORM：平台 OTHERS：其他 示例值：SUPPLIER |
{
"appid": "wx8888888888888888",
"type": "MERCHANT_ID",
"account": "190001001",
"name": "张三网络公司",
"relation_type": "SUPPLIER"
}
| 参数名 | 变量 | 类型[长度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 接收方类型 | type | string[1,32] | 是 | 分账接收方的类型，枚举值： MERCHANT_ID：商户 PERSONAL_OPENID：个人 示例值：MERCHANT_ID |
| 接收方账号 | account | string[1,64] | 是 | 分账接收方的账号 类型是MERCHANT_ID时，是商户号 类型是PERSONAL_OPENID时，是个人openid 示例值：190001001 |
{
"type": "MERCHANT_ID",
"account": "190001001"
}
| 状态码 | 错误码 | 描述 | 解决方案 |
|---|---|---|---|
| 500 | SYSTEM_ERROR | 系统错误 | 系统异常，请使用相同参数稍后重新调用 |
| 400 | PARAM_ERROR | 请求参数不符合参数格式 | 请使用正确的参数重新调用 |
| 400 | INVALID_REQUEST | 无效请求 | 请确认分账接收方是否存在 |
| 403 | NO_AUTH | 商户无权限 | 请开通商户号分账权限 |
| 429 | FREQUENCY_LIMITED | 添加接收方频率过高 | 请降低频率后重试 |