---
url: "https://pay.weixin.qq.com/doc/v3/partner/4012488950.md"
title: "提交已注销商户号可用余额提现申请单"
doc_id: 4012488950
---

>更新时间：2025.01.09

针对被微信支付平台不收不付管控的电商子商户，如子商户账户内还有可用余额，且无法解脱（例如 营业执照注销吊销），则服务商可为子商户申请走注销提现的流程，将可用余额进行提现操作。在商户号注销后，电商平台可发起提现申请, 审批通过后, 将会按照指定的收款方式返回给商户

请仔细阅读以下注意事项：

◆ 当返回错误码为“SYSTEMERROR”时，请不要更换商户提现申请单号，一定要使用原商户提现申请单号重试，否则可能造成重复支付等资金风险。

◆ 提交时遇到任何错误，请商户务必不要换单重试，请商户调用查询提现申请单状态接口确认提现申请单单据的状态, 再决定是否要换单重试, 避免重复提现

◆ 请商户在自身的系统中合理设置付款频次并做好并发控制，防范错付风险。

◆ 因商户自身系统设置存在问题导致的资金损失，由商户自行承担。




## 接口说明

支持商户：【平台商户】

请求方式：【POST】 `/v3/mch_operate/risk/withdrawl-apply`

请求域名：【主域名】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#%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` |
| Content-Type | string | true | 请设置为 `application/json` |
| Wechatpay-Serial | string | true | **【微信支付公钥ID】或【微信支付平台证书序列号】** 请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考 [获取微信支付公钥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)，也可以使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、 [平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md) |
### Body 参数
| 参数名 | 类型 | 必填 | 描述 |
| --- |  --- | --- | --- |
| sub_mchid | string(32) | true | **【二级商户号】** 资金出款电商平台二级商户号。即电商平台二级商户号，由微信支付生成并下发。调用该提现接口前，会要求该二级商户号已注销 |
| out_account_type | string | true | **【二级商户号的出款子账户类型】** 根据实际的出款子账户选择<br>可选取值：<br><ul><li>`BASIC_ACCOUNT`: 商户的基本户</li><li>`OPERATE_ACCOUNT`: 商户的运营账户</li><li>`MARGIN_ACCOUNT`:  商户的保证金户</li></ul> |
| amount | integer | true | **【提现金额】** 单位：分，提现金额不能超过二级商户号出款子账户的余额 |
| out_request_no | string(32) | true | **【商户提现申请单号】** 商户提现申请单号，由商户自定义生成，必须是字母数字 |
| payee_type | string | true | **【收款对象类型】** 根据实际的收款对象选择<br>可选取值：<br><ul><li>`CONTRIBUTION_MERCHANT`: 出资商户号收款，即已注销商户号资金提现给商户自己，收款账号类型对公银行卡账户 或 对私银行卡账户</li></ul><br><ul><li>`SERVICE_PROVIDER_MERCHANT`: 电商平台收款，即已注销商户号资金提现给服务商，收款账号类型支持电商平台同名对公银行卡账户</li></ul><br><ul><li>`OTHER_MERCHANT`: 其他商户号收款，即已注销商户号资金提现给其他商户，其他商户即除电商平台自身或出资商户号以外的商户, 收款账号类型视商户号主体类型，可支持对公或对私银行卡账户</li></ul><br><ul><li>`INDIVIDUAL`: 个人收款，即已注销商户号资金提现给个人银行卡（例如 给“达人、主播”），收款账号类型支持对私银行卡账户</li></ul> |
| payee_mchid | string(32) | false | **【收款对象对应的商户号】** 当收款对象不为个人时必填。<br>payee\_type为“SERVICE\_PROVIDER\_MERCHANT电商平台收款”，payee\_mchid填写对应电商平台服务商商户号；<br>payee\_type为“CONTRIBUTION\_MERCHANT出资商户号收款”，payee\_mchid填写对应二级子商户号；<br>payee\_type为“OTHER\_MERCHANT其他商户号收款”，payee\_mchid填写对应其他第三方收款商户号； |
| payee_info | object | true | **【收款账号信息】** 实际的收款账号 |
| payee_info.account_type | string | true | **【账户类型】** payee\_type为“CONTRIBUTION\_MERCHANT出资商户号收款”，则支持“对公”与“对私”。对私户名会校验是否与法人姓名一致；对公账户户名如与商户号主体不一致，则会要求提供对应授权函<br>如payee\_type为“SERVICE\_PROVIDER\_MERCHANT电商平台收款”，则仅支持“对公”，且要求户名与电商平台主体一致<br>如payee\_type为“OTHER\_MERCHANT其他商户号收款”，如商户号类型为企业类，仅支持“对公”，且要求户名与商户号主体一致；如商户号类型为个体户类，支持“对公”或“对私”，且对公户名需与商户号主体一致，对私户名需与商户号法人姓名一致<br>如payee\_type为“INDIVIDUAL个人收款”，仅支持对私户，户名不做要求，但需要提供对应函件<br>可选取值：<br><ul><li>`ACCOUNT_TYPE_CORPORATE`: 对公银行账户</li></ul><br><ul><li>`ACCOUNT_TYPE_PERSONAL`: 对私银行卡账户</li></ul> |
| payee_info.bank_account_info | object | true | **【银行账户】** 对应的银行账户 |
| payee_info.bank_account_info.account_name | string(2048) | true | **【开户名称】** 如payee\_type为“CONTRIBUTION\_MERCHANT出资商户号收款”，则支持“对公”与“对私”。对私户名会校验是否与法人姓名一致；对公账户户名如与商户号主体不一致，则会要求提供对应授权函<br>如payee\_type为“SERVICE\_PROVIDER\_MERCHANT电商平台收款”，则仅支持“对公”，且要求户名与电商平台主体一致<br>如payee\_type为“OTHER\_MERCHANT其他商户号收款”，如商户号类型为企业类，仅支持“对公”，且要求户名与商户号主体一致；如商户号类型为个体户类，支持“对公”或“对私”，且对公户名需与商户号主体一致，对私户名需与商户号法人姓名一致；<br>如payee\_type为“INDIVIDUAL个人收款”，仅支持对私户，户名不做要求，但需要提供对应函件<br>该字段需要使用微信支付公钥加密（推荐），请参考 [获取微信支付公钥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)，也可以使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](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 | **【开户银行】** 详细参见 [开户银行对照表](https://pay.weixin.qq.com/doc/v3/partner/4012082813.md) |
| payee_info.bank_account_info.bank_branch_id | string(128) | false | **【开户银行联行号】** 1、 [17家直连银行](https://pay.weixin.qq.com/doc/v3/partner/4012082813.md) 无需填写，如为其他银行，则开户银行全称（含支行）和 开户银行联行号二选一<br>2、详细参见 [开户银行全称（含支行）对照表](https://pay.weixin.qq.com/doc/v3/partner/4012082812.md) |
| payee_info.bank_account_info.bank_name | string(128) | false | **【开户银行全称（含支行）】** 1、 [17家直连银行](https://pay.weixin.qq.com/doc/v3/partner/4012082813.md) 无需填写，如为其他银行，则开户银行全称（含支行）和 开户银行联行号二选一<br>2、需填写银行全称，如"深圳农村商业银行XXX支行"<br>详细参见 [开户银行全称（含支行）对照表](https://pay.weixin.qq.com/doc/v3/partner/4012082812.md) |
| payee_info.bank_account_info.account_number | string(2048) | true | **【银行账号】** 1、数字，长度遵循系统支持的 [卡号长度要求表](https://pay.weixin.qq.com/doc/v3/partner/4012082813.md)<br>2、该字段需要使用微信支付公钥加密（推荐），请参考 [获取微信支付公钥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)，也可以使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](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_IDCARD`: 中国大陆居民-身份证</li></ul><br><ul><li>`IDENTIFICATION_TYPE_OVERSEA_PASSPORT`: 其他国家或地区居民-护照</li></ul><br><ul><li>`IDENTIFICATION_TYPE_HONGKONG_PASSPORT`: 中国香港居民-来往内地通行证</li></ul><br><ul><li>`IDENTIFICATION_TYPE_MACAO_PASSPORT`: 中国澳门居民-来往内地通行证</li></ul><br><ul><li>`IDENTIFICATION_TYPE_TAIWAN_PASSPORT`: 中国台湾居民-来往大陆通行证</li></ul><br><ul><li>`IDENTIFICATION_TYPE_FOREIGN_RESIDENT`: 外国人居留证</li></ul><br><ul><li>`IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT`: 港澳居民证</li></ul><br><ul><li>`IDENTIFICATION_TYPE_TAIWAN_RESIDENT`: 台湾居民证</li></ul> |
| payee_info.identity_info.identification_name | string(2048) | false | **【证件姓名】** 1、请填写个体户经营者/法定代表人对应身份证的姓名，2~30个中文字符、英文字符、符号<br>2、该字段需要使用微信支付公钥加密（推荐），请参考 [获取微信支付公钥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)，也可以使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、 [平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md)<br>3、当收款账户为付款到对私银行卡时, 必填 |
| payee_info.identity_info.identification_no | string(2048) | false | **【证件号码】** 1、如果证件类型为身份证, 需填写为15位数字或17位数字+1位数字&#124;X ，该字段需要使用微信支付公钥加密（推荐），请参考 [获取微信支付公钥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)，也可以使用微信支付平台证书公钥加密，参考 [获取平台证书序列号](https://pay.weixin.qq.com/doc/v3/partner/4013059181.md)、 [平台证书加密敏感信息指引](https://pay.weixin.qq.com/doc/v3/partner/4013059053.md)<br>2、当收款账户为付款到对私银行卡时, 必填 |
| proof_media_list | object | false | **【付款申请证明材料】** 各类证明材料, [填写规则](https://docs.qq.com/doc/p/075973b8c880b96b15b4c76a388bd62dac2d9eaa) |
| proof_media_list.proof_payee_media | array[object] | false | **【申请证明材料】** |
| proof_media_list.proof_payee_media.proof_media_type | string | true | **【申请证明材料类型】** 各种证明材料<br>可选取值：<br><ul><li>`WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_1`: 已废弃</li></ul><br><ul><li>`WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_2`: 已废弃</li></ul><br><ul><li>`WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_3`: 已废弃</li></ul><br><ul><li>`WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_4`: 已废弃</li></ul><br><ul><li>`WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_5`: 已废弃</li></ul><br><ul><li>`MISSING_OFFICIAL_SEAL_LETTER`: 已废弃</li></ul><br><ul><li>`CERTIFICATE_OF_ACCOUNT_CANCELLATION`: 已废弃</li></ul><br><ul><li>`INDUSTRIAL_AND_COMMERCIAL_CANCELLATION_CERTIFICATE`: 已废弃</li></ul><br><ul><li>`BASIC_TRANSACTION_INFORMATION`: 分账接收方与子商户的合作背景证明材料 (如合作协议)</li></ul><br><ul><li>`LEGAL_ID_CARD`: 法人身份证（或其他证件）正反面照片</li></ul><br><ul><li>`ID_CARD`: 经营负责人身份证（或其他证件）正反面照片</li></ul><br><ul><li>`BUSINESS_LICENSE_PHOTO`: 营业执照照片</li></ul><br><ul><li>`PAYEE_ID_CARD`: 收款人身份证正反面照片</li></ul><br><ul><li>`WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_6`: [附件6模板.pdf](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/attachment/c2102c72b744a79511a62e2972ed3773/附件6模板.pdf)</li><li>`WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_7`: [附件7模板.pdf](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/attachment/02d3308ebee8bfd78a3d488ef3f59936/附件7模板.pdf)</li><li>`WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_8`:[附件8模板.pdf](https://gtimg.wechatpay.cn/resource/xres/mmpaydoc/static/attachment/217cdbe61c4182437b9d6f91c228284a/附件8模板.pdf)</li></ul> |
| proof_media_list.proof_payee_media.proof_media | string(1024) | true | **【证明材料照片】** 1、请上传材料对应类型的图片<br>2、可上传1张图片，请填写通过 [图片上传](https://pay.weixin.qq.com/doc/v3/partner/4012760432.md) 接口预先上传图片生成好的MediaID |
| additional_materials | object | false | **【补充材料】** 1、不在上述证明材料中的其他需要服务商补充的，请填写通过 [图片上传](https://pay.weixin.qq.com/doc/v3/partner/4012760432.md) 接口预先上传图片生成好的MediaID |
| additional_materials.additional_media | array[string] | false | **【补充材料照片】** 最多可上传10张图片，请填写通过 [图片上传](https://pay.weixin.qq.com/doc/v3/partner/4012760432.md) 接口预先上传图片生成好的MediaID |
| remark | string(1024) | 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 | RESOURCE\_ALREADY\_EXISTS | 重复提交, 商户的提现申请单号已经存在, 请调用查询状态接口检查 | 重复提交, 商户的提现申请单号已经存在, 请调用查询状态接口检查 |
| 403 | NO\_AUTH | 商户暂无权限使用此功能 | 仅允许电商平台允许使用。 |
| 403 | NOTENOUGH | 二级商户号账户可用余额不足 | 二级商户号账户可用余额不足 |
| 429 | FREQUENCY\_LIMITED | 频率限制 | 请降低频率后重试 |

请求示例

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


应答示例

> 200 OK

```
{
  "applyment_id" : "20220101332222",
  "out_request_no" : "1234567"
}

```
