添加分账接收方

Header HTTP头参数

Authorization 　必填　string

Accept 　必填　string

Content-Type 　必填　string

Wechatpay-Serial 　必填　string

请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

body 包体参数

appid 　必填 string(32)

type 　必填 string

可选取值：

• MERCHANT_ID: 商户号

• PERSONAL_OPENID: 个人OpenID（普通商户由直连商户AppID转换得到，服务商模式由服务商AppID转换得到）

account 　必填 string(64)

name 　选填 string(1024)

【分账接收方全称】分账接收方类型是MERCHANT_ID时，是商户全称（必传），当商户是小微商户或个体户时，是开户人姓名
分账接收方类型是PERSONAL_OPENID时，是个人姓名（选传，传则校验）
1、此字段需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引
2、使用微信支付公钥或微信支付平台证书中的公钥
3、使用RSAES-OAEP算法进行加密
4、将请求中HTTP头部的Wechatpay-Serial设置为证书序列号

relation_type 　必填 string

可选取值：

• SERVICE_PROVIDER: 服务商

• STORE: 门店

• STAFF: 员工

• STORE_OWNER: 店主

• PARTNER: 合作伙伴

• HEADQUARTER: 总部

• BRAND: 品牌方

• DISTRIBUTOR: 分销商

• USER: 用户

• SUPPLIER: 供应商

• CUSTOM: 自定义

custom_relation 　选填 string(10)

请求示例

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/profitsharing/receivers/add \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "appid" : "wx8888888888888888",
9    "type" : "MERCHANT_ID",
10    "account" : "86693852",
11    "name" : "hu89ohu89ohu89o",
12    "relation_type" : "SERVICE_PROVIDER",
13    "custom_relation" : "代理商"
14  }'

type 　必填 string

可选取值：

• MERCHANT_ID: 商户号

• PERSONAL_OPENID: 个人OpenID（普通商户由直连商户AppID转换得到，服务商模式由服务商AppID转换得到）

account 　必填 string(64)

name 　选填 string(1024)

【分账接收方全称】该字段已做加密处理，具体解密方法详见如何使用API证书解密敏感字段

relation_type 　必填 string

可选取值：

• SERVICE_PROVIDER: 服务商

• STORE: 门店

• STAFF: 员工

• STORE_OWNER: 店主

• PARTNER: 合作伙伴

• HEADQUARTER: 总部

• BRAND: 品牌方

• DISTRIBUTOR: 分销商

• USER: 用户

• SUPPLIER: 供应商

• CUSTOM: 自定义

custom_relation 　选填 string(10)

应答示例

200 OK

1{
2  "type" : "MERCHANT_ID",
3  "account" : "example_account",
4  "name" : "example_name",
5  "relation_type" : "SERVICE_PROVIDER",
6  "custom_relation" : "example_custom_relation"
7}