添加分账接收方

更新时间：2024.11.14

应用场景

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

注意：

服务商需确保向微信支付传输用户身份信息和账号标识信息做一致性校验已合法征得用户授权

接口说明

请求Url	https://api.mch.weixin.qq.com/pay/profitsharingaddreceiver
是否需要证书	否
请求方式	post
签名方式	HMAC-SHA256

请求参数

名称

变量名

必填

类型

示例值

描述

商户号

mch_id

是

string(32)

1900000100

微信支付分配的服务商商户号

子商户号

sub_mch_id

二选一

string(32)

1900000109

微信支付分配的子商户号，即分账的出资商户号。

品牌主商户号

brand_mch_id

string(32)

1900000109

当开通了“连锁品牌工具”后，使用品牌供应链分账时，分账接收方需配置在品牌主维度。子商户号和品牌主商户号二选一填写。

公众账号ID

appid

是

string(32)

wx8888888888888888

微信分配的服务商appid

子商户公众账号ID

sub_appid

否

string(32)

wx8888888888888888

微信分配的子商户公众账号ID

随机字符串

nonce_str

是

string(32)

5K8264ILTKCH16CQ2502SI8ZNMTM67VS

随机字符串，不长于32位。推荐随机数生成算法

签名

sign

是

string(64)

ABC6DD4AA85C0EECA82C35595A69EFGH

签名，详见签名生成算法

签名类型

sign_type

否

string(32)

HMAC-SHA256

签名类型，目前只支持HMAC-SHA256

分账接收方

receiver

是

String(2048)

内容见下方示例

分账接收方对象，json格式

点击下行的>展开字段详情

分账接收方

举例如下：

1<xml>
2   <mch_id>10000100</mch_id>
3   <sub_mch_id>1415701182</sub_mch_id>
4<appid>wx2421b1c4370ec43b</appid>
5   <sub_appid>wx2203b1494370e08cm</sub_appid>
6   <nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str> 
7   <sign>ABC6DD4AA85C0EECA82C35595A69EFGH</sign>
8<sign_type>HMAC-SHA256</sign_type>
9   <receiver>
10{
11       "type": "MERCHANT_ID",
12       "account": "190001001",
13       "name": "示例商户全称",
14"relation_type": "STORE_OWNER"
15}
16</receiver>
17</xml>

返回结果

名称	变量名	必填	类型	示例值	描述
返回状态码	return_code	是	string(32)	SUCCESS	SUCCESS/FAIL 此字段是通信标识，非交易标识
返回信息	return_msg	否	string(256)	参数格式校验错误	返回信息，如非空，为错误原因

以下字段在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(2048)	{"type":"MERCHANT_ID","account":"190001001"}	分账接收方对象（不包含分账接收方全称），json格式
随机字符串	nonce_str	是	string(32)	5K8264ILTKCH16CQ2502SI8ZNMTM67VS	微信返回的随机字符串
签名	sign	是	string(64)	ABC6DD4AA85C0EECA82C35595A69EFGH	微信返回的签名，详见签名算法

错误码列表

名称	描述	原因	解决方案
SYSTEMERROR	接口返回错误	系统超时	请使用相同参数再次调用API
PARAM_ERROR	参数错误	请求参数未按指引进行填写	请求参数错误，请重新检查再调用API
INVALID_REQUEST	请求不合法	参数中APPID或 MCHID不存在等	请检查请求参数
OPENID_MISMATCH	Openid错误	Openid 与Appid不匹配	请检查Openid 是否正确
FREQUENCY_LIMITED	频率限制	请求过多被频率限制	该笔请求未受理，请降低频率后原单重试
NOAUTH	无分账权限	未开通分账权限	请先开通分账
USER_NOT_EXIST	分账接收方不存在	分账接收方不存在	请确认分账接收方类型或者账号无误后重试
ACCOUNTERROR	分账接收方账户不存在	账户未开通	账户未开通，请接收方商户在商户平台点击“充值”创建账户

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服