微信支付境外文档-分账

返回上一层分账 / 删除分账接收方API

删除分账接收方API

最新更新时间：2022.04.11 版本说明

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

接口说明

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

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

请求方式：delete

path 指该参数为路径参数

query 指该参数为URL参数

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

请求参数

参数名	变量	类型[长度限制]	必填	描述
二级商户号	sub_mchid	string[1, 32]	否	body微信支付分配的商户号，请与微信支付订单的二级商户号保持一致。（直连商户不需要，服务商/机构模式下必填）示例值：1900000109
公众账号ID	appid	string[1, 32]	否	body与机构商户绑定的公众账号ID(AppID)，平台会校验该字段与机构商之间是否存在有效绑定关系。分账接收方类型包含“PERSONAL_OPENID”时必填。示例值：wx8888888888888888
二级商户公众账号ID	sub_appid	string[1, 32]	否	body机构服务商为二级商户配置绑定的公众账号ID，平台会校验机构服务商、二级商户和SubAppID之间的有效绑定关系。分账接收方类型包含“PERSONAL_SUB_OPENID”时必填。示例值：wx8888888888888889
接收方类型	type	string	是	body接收方类型 MERCHANT_ID：商户号， PERSONAL_OPENID：AppID对应的OpenID PERSONAL_SUB_OPENID：SubAppID对应的OpenID 示例值：MERCHANT_ID
接收方账号	account	string[1, 64]	是	body类型是MERCHANT_ID时，请填入商户号类型是PERSONAL_OPENID时，请填入AppID对应的OpenID 类型是PERSONAL_SUB_OPENID时，请填入SubAppID对应的OpenID 示例值：86693852

请求示例


{
    "account": "1900000109",
    "sub_mchid": "1900000109",
    "type": "MERCHANT_ID"
  }


{
    "account": "86693852",
    "appid": "wx8888888888888888", 
    "type": "MERCHANT_ID", 
    "sub_mchid": "1900000109"
}

返回参数

处理成功，应答无内容

返回示例

正常示例

 
204
处理成功，应答无内容


http://2323weixin.qq.com

错误码

状态码	错误码	描述	解决方案
400	INVALID_REQUEST	用户类型为PERSONAL_OPENID，参数appid未设置	用户类型为PERSONAL_OPENID，请设置appid字段
400	INVALID_REQUEST	用户类型为PERSONAL_SUB_OPENID，参数sub_appid未设置	用户类型为PERSONAL_SUB_OPENID，请设置sub_appid字段
400	INVALID_REQUEST	若接收方类型为MERCHANT_ID，请在name字段设置接收方商户全称	若接收方类型为MERCHANT_ID，请在name字段设置接收方商户全称
400	INVALID_REQUEST	若接收方类型为MERCHANT_ID，请在major_service字段设置接收方商户的主营业务范围	请检查分账接收方列表，去除同一次分账请求中的重复账户后再执行请求
400	INVALID_REQUEST	若接收方关系类型为CUSTOM时，请设置custom_relation字段	若接收方关系类型为CUSTOM时，请设置custom_relation字段
400	INVALID_REQUEST	个人接收方选择传入姓名字段但未确认用户授权状态	若选择传入个人接收方姓名以执行用户实名信息一致性校验，需要商户先获取用户授权，并设置authorized字段为true
400	INVALID_REQUEST	个人接收方在微信侧的实名信息与传入的姓名字段值不一致	请和接收方用户确认实名信息无误后，再执行请求
400	INVALID_REQUEST	已经存在一条分账接收方方关系记录，且预期最大分出比例（expected_ratio）与本次请求不符	请检查账户及预期最大分出比例是否填写正确，若已经添加过该接收方，可通过【查询分账接收方添加结果API】查询结果
400	INVALID_REQUEST	已经存在一条分账接收方方关系记录，且上传的审核文件ID字段（file_id）与本次请求不符	请检查账户及审核文件ID字段（file_id）是否填写正确，若已经添加过该接收方，可通过【查询分账接收方添加结果API】查询结果
403	NO_AUTH	商户未签约境外分账产品能力	请参考产品流程和接入准备，确认商户具有分账权限后再发起请求
403	NO_AUTH	商户已开通分账产品能力，等待生效中(一般为第二天才生效)	开通分账产品能力当天不能发起分账，请等待第二天后发起请求
403	NO_AUTH	分账接收方境外权限被处罚	请确认分账接收方均合法合规后，再发起请求
403	NO_AUTH	商户父子关系不存在，请使用正确的二级商户号发起请求	请检查二级商户号(sub_mchid)是否填写正确

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

境外分账API

删除分账接收方API

接口说明

请求参数

请求示例

返回参数

返回示例

错误码

版本说明