---
url: "https://pay.weixin.qq.com/doc/v3/partner/4013892756.md"
title: "提交注销提现申请"
doc_id: 4013892756
---

>更新时间：2025.03.13

本接口用于商户号注销、商户号注销及提现。当平台二级商户需要注销商户号，或需要注销商户号并提现商户号可用余额的商户，由其所属的平台商户调用此接口发起申请。

注意事项：

1. 仅针对被微信支付管控、且无法解脱该管控的商户，可通过此接口发起注销提现。例如商户营业执照注销吊销。

2. 申请单审核通过并经过商户确认后，账户内所有余额将打款至商户号指定的银行卡账户，如商户有多个账户，将会多笔入账

3. 审核通过后，超过30天未经商户确认的单据将做撤销处理





## 接口说明

支持商户：【平台商户】

请求方式：【POST】 `/v3/ecommerce/account/apply-cancel-withdraw`

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

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

## 请求参数

### Header 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| Authorization | string | true | 请参考 [签名认证](https://pay.weixin.qq.com/doc/v3/partner/4012365870.md) 生成认证信息 |
| Accept | string | true | 请设置为 `application/json` |
| Content-Type | string | true | 请设置为 `application/json` |
| Wechatpay-Serial | string | true | 【微信支付公钥ID】或【微信支付平台证书序列号】  请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考 [获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q:-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID?) 以及 [微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/merchant/4013053257.md)；也可以使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/merchant/4013053294.md)、 [平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md) |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | true | 【申请注销的二级商户号】 平台商户的二级商户号，由微信支付生成并下发 |
| out_request_no | string(32) | true | 【商户注销申请单号】 商户注销申请单号，由商户自定义生成，要求在服务商维度下是唯一的，必须仅包含大小写字母与数字 |
| withdraw | string | false | 【是否提取资金】 支持被微信支付平台不收不付管控的二级商户填写此字段，填写后需要填写注销的提现银行卡信息，微信支付会将所有的账户内可提现资金提取至对应银行卡<br>填写前，建议平台商户查询二级商户是否存在消费者投诉或风险处罚原因冻结的资金，避免错误驳回<br>可选取值<br><ul><li>`NOT_APPLY_WITHDRAW`:  仅注销，不申请提现</li><li>`APPLY_WITHDRAW`:  申请提现</li></ul> |
| payee_info | object | false | 【收款账号信息】 收款账号 |
| payee_info.account_type | string | true | 【账户类型】 1、若主体为营业执照未注销吊销的企业，可填写：对公银行账户<br>2、若主体为营业执照已经注吊销的企业，可填写：对公银行账户、对私银行账户<br>3、主体为小微/个人卖家，可填写：对公银行账户、对私银行账户<br>4、若主体为营业执照未注销吊销的个体工商户，可填写：对公银行账户、对私银行账户<br>5、若主体为营业执照已注销吊销的个体工商户，可填写：对私银行账户<br>6、主体类型为政府机关/事业单位/社会组织，可填写：对公银行账户<br>可选取值<br><ul><li>`ACCOUNT_TYPE_CORPORATE`:  对公银行账户</li><li>`ACCOUNT_TYPE_PERSONAL`:  对私银行卡账户</li></ul> |
| payee_info.bank_account_info | object | true | 【银行账户】 对应的银行账户 |
| payee_info.bank_account_info.account_name | string(2048) | true | 【开户名称】 1、选择对私银行账户时，开户名称必须与法人身份证姓名一致；<br>2、选择对公账户时，开户名称必须与营业执照上的“商户名称”一致。如不一致，需要填写补充资料字段；<br>3、该字段需要进行加密，可以选取任一方式加密：1）使用微信支付公钥加密（推荐使用），请参考 [获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q%3A-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID%3F) 以及 [微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)，2）使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、 [平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md) |
| payee_info.bank_account_info.account_bank | string(128) | true | 【开户银行】 请填写开户银行名称<br>对私银行调用： [查询支持个人业务的银行列表API](https://pay.weixin.qq.com/doc/v3/partner/4012697583.md)<br>对公银行调用： [查询支持对公业务的银行列表API](https://pay.weixin.qq.com/doc/v3/partner/4012697626.md) |
| payee_info.bank_account_info.bank_branch_id | string(128) | false | 【开户银行联行号】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。<br>2、详细需调用 [查询支行列表API](https://pay.weixin.qq.com/doc/v3/partner/4012697673.md) 查看查询结果。 |
| payee_info.bank_account_info.bank_branch_name | string(128) | false | 【开户银行全称（含支行）】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行，开户银行全称（含支行）和开户银行联行号二选一。<br>2、详细需调用 [查询支行列表API](https://pay.weixin.qq.com/doc/v3/partner/4012697673.md) 查看查询结果。 |
| payee_info.bank_account_info.account_number | string(2048) | true | 【银行账号】 1、数字，长度遵循系统支持的 [开户银行对照表](https://pay.weixin.qq.com/doc/v3/partner/4012082813.md) 中对公/对私卡号长度要求<br>2、该字段需要进行加密，可以选取任一方式加密：1）使用微信支付公钥加密（推荐使用），请参考 [获取微信支付公钥ID说明](https://pay.weixin.qq.com/doc/v3/partner/4013038589.md#Q%3A-%E5%A6%82%E4%BD%95%E8%8E%B7%E5%8F%96%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E5%85%AC%E9%92%A5ID%3F) 以及 [微信支付公钥加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)，2）使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、 [平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md) |
| payee_info.identity_info | object | false | 【收款人账号对应的证件信息】 当收款账户为付款到对私银行卡时，需要提供对私账户开户人的身份证件信息，必填， 以下 `id_doc_type`、 `identification_name`、 `identification_no` 必填 |
| payee_info.identity_info.id_doc_type | string | false | 【证件类型】 1、对私账户开户人的身份证件类型<br>2、当收款账户为付款到对私银行卡时 必填<br>可选取值<br><ul><li>`IDENTIFICATION_TYPE_ID_CARD`:  中国大陆居民-身份证</li><li>`IDENTIFICATION_TYPE_OVERSEA_PASSPORT`:  其他国家或地区居民-护照</li><li>`IDENTIFICATION_TYPE_HONGKONG_PASSPORT`:  中国香港居民-来往内地通行证</li><li>`IDENTIFICATION_TYPE_MACAO_PASSPORT`:  中国澳门居民-来往内地通行证</li><li>`IDENTIFICATION_TYPE_TAIWAN_PASSPORT`:  中国台湾居民-来往大陆通行证</li><li>`IDENTIFICATION_TYPE_FOREIGN_RESIDENT`:  外国人居留证</li><li>`IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT`:  港澳居民证</li><li>`IDENTIFICATION_TYPE_TAIWAN_RESIDENT`:  台湾居民证</li></ul> |
| payee_info.identity_info.identification_name | string(2048) | false | 【证件姓名】 1、请填写个体户经营者/法定代表人对应身份证的姓名，2~30个中文字符、英文字符、符号<br>2、该字段需进行加密处理，加密方法详见 [敏感信息加密说明](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)<br>3、当收款账户为付款到对私银行卡时, 必填 |
| payee_info.identity_info.identification_no | string(2048) | false | 【证件号码】 1、如果证件类型为身份证, 需填写为15位数字或17位数字+1位数字&#124;X ，该字段需进行加密处理，加密方法详见 [敏感信息加密说明](https://pay.weixin.qq.com/doc/v3/partner/4013059044.md)<br>2、当收款账户为付款到对私银行卡时, 必填 |
| proof_medias | array[ProofMedia] | false | 【付款申请材料】 填写条件：<br>主体为企业，且经营证照注吊撤，必填；<br>主体为事业单位/政府机关/社会组织，必填；<br>其他主体类型的商户，即主体为小微商户/个体工商户/经营证照存续的企业，无需填写 |
| proof_medias.proof_media_type | string | true | 【付款申请材料类型】 付款申请材料类型<br>可选取值<br><ul><li>`WITHDRAWAL_APPLICATION`:  [模版下载](https://gtimg.wechatpay.cn/resource/xres/wechat_pay_system/merchant_basic/mch_api/%E5%BE%AE%E4%BF%A1%E6%94%AF%E4%BB%98%E7%94%B5%E5%95%86%E6%94%B6%E4%BB%98%E9%80%9A%E5%AD%90%E5%95%86%E6%88%B7%E5%8F%B7%E6%B3%A8%E9%94%80%E5%90%8E%E5%8F%AF%E7%94%A8%E4%BD%99%E9%A2%9D%E6%8F%90%E5%8F%96%E7%94%B3%E8%AF%B7%E4%B9%A6.pdf)</li></ul> |
| proof_medias.proof_media | string(1024) | true | 【证明材料照片】 1、请上传材料对应类型的图片<br>2、可上传1张图片，请填写通过 [图片上传](https://pay.weixin.qq.com/doc/v3/partner/4012760432.md) 接口预先上传图片生成好的MediaID |
| additional_materials | array[string] | false | 【其他补充材料】 不在上述证明材料中的其他需要服务商补充的，请填写通过 [图片上传](https://pay.weixin.qq.com/doc/v3/partner/4012760432.md) 接口预先上传图片生成好的MediaID，最多可上传10张图片 |
| remark | string(32) | false | 【备注】 付款申请备注，传入后将展示在收款银行系统中，可供平台与二级商户进行对账。由数字、字母、汉字组成（能否成功展示依赖银行系统支持）。 |
## 应答参数

200 OK

| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| applyment_id | string(32) | false | 【微信支付注销提现申请单号】 电商平台提交二级商户注销提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识 |
| out_request_no | string(32) | false | 【商户注销申请单号】 商户注销申请单号，由商户自定义生成，需要全局唯一 |
## 错误码

### 公共错误码

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

### 业务错误码

| 状态码 | 错误码 | 描述 | 解决方案 |
| --- | --- | --- | --- |
| 400 | BIZ\_ERR\_NEED\_RETRY | 系统异常，请求稍后重试 | 请稍后重试 |
| 400 | ALREADY\_EXISTS | out\_request\_no已使用 | 更换out\_request\_no重试 |

请求示例

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


应答示例

> 200 OK

```
{
  "applyment_id" : "X202410241010125346",
  "out_request_no" : "P202410241010125346"
}
```
