删除分账接收方

更新时间:2024.11.14

应用场景

服务商代子商户发起删除分账接收方请求,删除后不支持将结算后的钱分到该分账接收方。

接口说明

请求Url

https://api.mch.weixin.qq.com/pay/profitsharingremovereceiver

是否需要证书

请求方式

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}
15</receiver>
16</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

分账接收方不存在

分账接收方不存在

请确认分账接收方类型或者账号无误后重试

 

更多技术问题
技术咨询
反馈
咨询
目录
置顶