# 添加分账接收方

使用本接口需要开启开放接口服务

服务商代子商户发起添加分账接收方请求，后续可通过发起分账请求将结算后的钱分到该分账接收方。

http://api.weixin.qq.com/_/pay/profitsharingaddreceiver

receiver 对象：

名称	变量名	必填	类型	示例值	描述
分账接收方类型	type	是	string(32)	MERCHANT_ID	MERCHANT_ID：商户ID PERSONAL_OPENID：个人openid（由父商户APPID转换得到）PERSONAL_SUB_OPENID: 个人sub_openid（由子商户APPID转换得到）
分账接收方账号	account	是	string(64)	86693852	类型是MERCHANT_ID时，是商户ID 类型是PERSONAL_OPENID时，是个人openid 类型是PERSONAL_SUB_OPENID时，是个人sub_openid
分账接收方全称	name	否	string(1024)	示例商户全称	分账接收方类型是MERCHANT_ID时，是商户全称（必传）分账接收方类型是PERSONAL_OPENID时，是个人姓名（选传，传则校验）分账接收方类型是PERSONAL_SUB_OPENID时，是个人姓名（选传，传则校验）
与分账方的关系类型	relation_type	是	string(32)	SERVICE_PROVIDER	子商户与接收方的关系。本字段值为枚举： SERVICE_PROVIDER：服务商 STORE：门店 STAFF：员工 STORE_OWNER：店主 PARTNER：合作伙伴 HEADQUARTER：总部 BRAND：品牌方 DISTRIBUTOR：分销商 USER：用户 SUPPLIER：供应商 CUSTOM：自定义
自定义的分账关系	custom_relation	否	string(10)	代理商	子商户与接收方具体的关系，本字段最多10个字。当字段relation_type的值为CUSTOM时，本字段必填当字段relation_type的值不为CUSTOM时，本字段无需填写

字段名	变量名	必填	类型	示例值	描述
返回状态码	return_code	是	String(16)	SUCCESS	SUCCESS/FAIL
返回信息	return_msg	否	String(128)	签名失败	返回信息，如非空，为错误原因。如签名失败、参数格式校验错误

以下字段在return_code为SUCCESS的时候有返回

名称	变量名	必填	类型	示例值	描述
业务结果	result_code	是	string(32)	SUCCESS	SUCCESS：添加分账接收方成功 FAIL ：提交业务失败
错误代码	err_code	否	string(32)	SYSTEMERROR	列表详见错误码列表
错误代码描述	err_code_des	否	String(128)	系统超时	结果信息描述
商户号	mch_id	是	string(32)	1900000100	调用接口时提供的商户号
子商户号	sub_mch_id	是	string(32)	1900000109	微信支付分配特约商户的商户号
公众账号ID	appid	是	string(32)	wx8888888888888888	调用接口提供的公众账号ID
子商户公众账号ID	sub_appid	否	string(32)	wx8888888888888888	微信分配的子商户公众账号ID
分账接收方	receiver	是	String(128)	{"type":"MERCHANT_ID","account":"190001001"}	分账接收方对象（不包含分账接收方全称），json格式
随机字符串	nonce_str	是	string(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	微信返回的随机字符串
签名	sign	是	string(64)	ABC6DD4AA85C0EECA82C35595A69EFGH	微信返回的签名，详见签名算法