添加分账接收方

应用场景

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

接口说明

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

请求参数

名称

变量名

必填

类型

示例值

描述

商户号

mch_id

string(32)

1900000100

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

子商户号

sub_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格式

点击行前的+展开字段详情

举例如下:

<xml>
   <mch_id>10000100</mch_id>
   <sub_mch_id>1415701182</sub_mch_id>
<appid>wx2421b1c4370ec43b</appid>
   <sub_appid>wx2203b1494370e08cm</sub_appid>
   <nonce_str>6cefdb308e1e2e8aabd48cf79e546a02</nonce_str> 
   <sign>ABC6DD4AA85C0EECA82C35595A69EFGH</sign>
<sign_type>HMAC-SHA256</sign_type>
   <receiver>
{
       "type": "MERCHANT_ID",
       "account": "190001001",
       "name": "示例商户全称",
"relation_type": "STORE_OWNER"
}
</receiver>
</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(128)

{"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

分账接收方账户不存在

账户未开通

账户未开通,请接收方商户在商户平台点击“充值”创建账户