删除分账接收方

更新时间：2025.01.07

商户发起删除分账接收方请求。删除后，不支持将分账方商户结算后的资金再分给该分账接收方。

1. 接口说明

适用对象：直连模式机构模式

请求URL：https://apihk.mch.weixin.qq.com/v3/global/profit-sharing/receivers

请求方式：Delete

Path 指该参数为路径参数

Query 指该参数为URL参数

Body 指该参数需在请求JSON传参

2. 请求参数

参数名	变量	类型[长度限制]	必填	描述
二级商户号	sub_mchid	string[1, 32]	否	Body 微信支付分配的商户号，请与微信支付订单的二级商户号保持一致。（直连商户不需要，服务商/机构模式下必填）示例值：1900000109
公众账号ID	appid	string[1, 32]	否	Body 微信分配的商户公众账号ID，分账接收方类型包含PERSONAL_OPENID时必填。示例值：wx8888888888888888
二级商户公众账号ID	sub_appid	string[1, 32]	否	Body 微信分配的二级商户公众账号ID，分账接收方类型包含PERSONAL_SUB_OPENID时必填。示例值：wx8888888888888889
接收方类型	type	string	是	Body 接收方类型 MERCHANT_ID：商户号， PERSONAL_OPENID：个人OpenID，由商户APPID转换得到 PERSONAL_SUB_OPENID：是个人Sub_OpenID，由二级商户APPID转换得到示例值：MERCHANT_ID
接收方账号	account	string[1, 64]	是	Body 类型是MERCHANT_ID时，是商户号类型是PERSONAL_OPENID时，是个人OpenID 类型是PERSONAL_SUB_OPENID时，是个人Sub_OpenID 示例值：86693852

请求示例

删除商户接收方

1{
2    "account": "1900000109",
3    "sub_mchid": "999968480",
4    "type": "MERCHANT_ID"
5  }

删除用户接收方

1{
2    "account": "of8YZ6LPmjDmYAqdobIvwTdQQjR8",
3    "appid": "wx78898sdfwe9888835", 
4    "type": "PERSONAL_OPENID", 
5    "sub_mchid": "999968480"
6}

3. 返回参数

处理成功，应答无内容

返回示例

正常示例

1204
2处理成功，应答无内容

4. 错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	用户类型为PERSONAL_OPENID，参数appid未设置	用户类型为PERSONAL_OPENID，请设置appid字段
400	INVALID_REQUEST	用户类型为PERSONAL_SUB_OPENID，参数sub_appid未设置	用户类型为PERSONAL_SUB_OPENID，请设置sub_appid字段
403	NO_AUTH	商户未签约境外分账产品能力	请参考产品流程和接入准备，确认商户具有分账权限后再发起请求
403	NO_AUTH	商户已开通分账产品能力，等待生效中(一般为第二天才生效)	开通分账产品能力当天不能发起分账，请等待第二天后发起请求
403	NO_AUTH	分账接收方境外权限被处罚	请确认分账接收方均合法合规后，再发起请求
403	NO_AUTH	商户父子关系不存在，请使用正确的二级商户号发起请求	请检查二级商户号(sub_mchid)是否填写正确