---
url: "https://pay.weixin.qq.com/doc/v3/partner/4016420099.md"
title: "商户注销资格校验"
doc_id: 4016420099
---

>更新时间：2025.11.05

电商平台发起注销提现申请前，可通过该接口判断商户是否满足注销条件




## 接口说明

支持商户：【普通服务商】

请求方式：【GET】 `/v3/ecommerce/account/apply-cancel-withdraw/validate-cancel/{sub_mchid}`

请求域名：【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引[点击查看](https://pay.weixin.qq.com/doc/v3/merchant/4012075113.md)

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/merchant/4012365342.md#%E8%AF%B7%E6%B1%82%E6%8E%A5%E5%8F%A3%E5%90%8E%E7%AB%AF%E7%AD%BE%E5%90%8D) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
### Path 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | true | 【申请注销的二级商户号】 平台商户的二级商户号，由微信支付生成并下发 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | true | 【注销检查的二级商户号】 平台商户的二级商户号，由微信支付生成并下发 |
| merchant_state | string | true | 【商户号状态】 商户号状态<br>可选取值<br><ul><li>`NORMAL`:  正常</li><li>`HAS_BEEN_CANCELLED`:  已注销</li></ul> |
| validate_result | string | true | 【注销资格检查结果】 注销资格检查结果<br>可选取值<br><ul><li>`ALLOW_CANCEL_WITHDRAW`:  可发起注销提现申请</li><li>`NOT_ALLOW_CANCEL_WITHDRAW`:  不可发起注销提现申请</li></ul> |
| account_info | array[object] | false | 【商户资金账户余额】 二级商户号已开通的账户余额信息，接口返回的余额是实时数据。在查询后，商户可能仍有新的交易入账导致余额变动。发起资金清退申请前，请再次调用本接口进行确认。清退申请提交后，微信支付会将商户账户里所有遗留的资金全额清退。 |
| account_info.out_account_type | string | true | 【二级商户号的出款子账户类型】 仅返回已开通的账户类型<br>可选取值<br><ul><li>`BASIC_ACCOUNT`:  商户的基本户</li><li>`OPERATE_ACCOUNT`:  商户的运营账户</li><li>`MARGIN_ACCOUNT`:  商户的保证金户</li><li>`TRADE_FEE_ACCOUNT`:  商户的手续费账户</li></ul> |
| account_info.amount | integer | true | 【账户金额】 单位：分 |
| block_reasons | array[object] | false | 【不可发起注销原因】 商户号未注销时返回此字段，同个商户可能返回多个不可注销原因，可引导商户进行处理 |
| block_reasons.type | string | false | 【原因类型】 原因类型<br>可选取值<br><ul><li>`CONSUMER_COMPLAINT_UNPROCESSED`:  消费者投诉未处理</li><li>`HAS_BLOCKING_CONTROL`:  存在不可注销管控</li><li>`FUNDS_PENDING_PROCESSING`:  商户资金待处理</li><li>`OTHER_REASON`:  其他原因</li></ul> |
| block_reasons.description | string(512) | false | 【原因描述】 原因描述 |
## 错误码

以下是本接口返回的错误码列表。详细错误码规则，请参考[微信支付接口规则-错误码和错误提示](https://pay.weixin.qq.com/doc/v3/partner/4012081726.md#%E9%94%99%E8%AF%AF%E7%A0%81%E5%92%8C%E9%94%99%E8%AF%AF%E6%8F%90%E7%A4%BA)

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | PARAM\_ERROR | 参数错误 | 请根据错误提示正确传入参数 |
| 400 | INVALID\_REQUEST | HTTP 请求不符合微信支付 APIv3 接口规则 | 请参阅 [接口规则](https://pay.weixin.qq.com/doc/v3/merchant/4012081709.md) |
| 401 | SIGN\_ERROR | 验证不通过 | 请参阅 [签名常见问题](https://pay.weixin.qq.com/doc/v3/merchant/4012072670.md) |
| 500 | SYSTEM\_ERROR | 系统异常，请稍后重试 | 请稍后重试 |

请求示例

- [curl 示例](https://pay.weixin.qq.com/doc/v3/partner/4016420099-curl.md)
- [Java 示例](https://pay.weixin.qq.com/doc/v3/partner/4016420099-java.md)
- [Go 示例](https://pay.weixin.qq.com/doc/v3/partner/4016420099-go.md)


应答示例

> 200 OK

```
{
  "sub_mchid" : "1900000109",
  "merchant_state" : "NORMAL",
  "validate_result" : "ALLOW_CANCEL_WITHDRAW",
  "account_info" : [
    {
      "out_account_type" : "BASIC_ACCOUNT",
      "amount" : 101
    }
  ],
  "block_reasons" : [
    {
      "type" : "CONSUMER_COMPLAINT_UNPROCESSED",
      "description" : "该商户存在冻结资金或在途资金，请先处理资金再申请注销"
    }
  ]
}

```
