提交注销提现申请

更新时间：2025.03.13

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

仅针对被微信支付管控、且无法解脱该管控的商户，可通过此接口发起注销提现。例如商户营业执照注销吊销。
申请单审核通过并经过商户确认后，账户内所有余额将打款至商户号指定的银行卡账户，如商户有多个账户，将会多笔入账
审核通过后，超过30天未经商户确认的单据将做撤销处理

接口说明

支持商户：【平台商户】

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

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

　　　　　【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点，指引点击查看

请求参数

Header HTTP头参数

Authorization 　必填　string

请参考签名认证生成认证信息

Accept 　必填　string

请设置为application/json

Content-Type 　必填　string

请设置为application/json

Wechatpay-Serial 　必填　string

【微信支付公钥ID】或【微信支付平台证书序列号】请求参数中的敏感字段，需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引；也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

body 包体参数

sub_mchid 　必填 string(32)

【申请注销的二级商户号】平台商户的二级商户号，由微信支付生成并下发

out_request_no 　必填 string(32)

【商户注销申请单号】商户注销申请单号，由商户自定义生成，要求在服务商维度下是唯一的，必须仅包含大小写字母与数字

withdraw 　选填 string

【是否提取资金】支持被微信支付平台不收不付管控的二级商户填写此字段，填写后需要填写注销的提现银行卡信息，微信支付会将所有的账户内可提现资金提取至对应银行卡

填写前，建议平台商户查询二级商户是否存在消费者投诉或风险处罚原因冻结的资金，避免错误驳回

可选取值

NOT_APPLY_WITHDRAW: 仅注销，不申请提现
APPLY_WITHDRAW: 申请提现

payee_info 　选填 object

【收款账号信息】收款账号

属性

account_type 　必填 string

【账户类型】 1、若主体为营业执照未注销吊销的企业，可填写：对公银行账户
2、若主体为营业执照已经注吊销的企业，可填写：对公银行账户、对私银行账户
3、主体为小微/个人卖家，可填写：对公银行账户、对私银行账户
4、若主体为营业执照未注销吊销的个体工商户，可填写：对公银行账户、对私银行账户
5、若主体为营业执照已注销吊销的个体工商户，可填写：对私银行账户
6、主体类型为政府机关/事业单位/社会组织，可填写：对公银行账户

可选取值

ACCOUNT_TYPE_CORPORATE: 对公银行账户
ACCOUNT_TYPE_PERSONAL: 对私银行卡账户

bank_account_info 　必填 object

【银行账户】对应的银行账户

属性

identity_info 　选填 object

【收款人账号对应的证件信息】当收款账户为付款到对私银行卡时，需要提供对私账户开户人的身份证件信息，必填，以下id_doc_type、identification_name、identification_no 必填

属性

id_doc_type 　选填 string

【证件类型】 1、对私账户开户人的身份证件类型
2、当收款账户为付款到对私银行卡时必填

可选取值

IDENTIFICATION_TYPE_ID_CARD: 中国大陆居民-身份证
IDENTIFICATION_TYPE_OVERSEA_PASSPORT: 其他国家或地区居民-护照
IDENTIFICATION_TYPE_HONGKONG_PASSPORT: 中国香港居民-来往内地通行证
IDENTIFICATION_TYPE_MACAO_PASSPORT: 中国澳门居民-来往内地通行证
IDENTIFICATION_TYPE_TAIWAN_PASSPORT: 中国台湾居民-来往大陆通行证
IDENTIFICATION_TYPE_FOREIGN_RESIDENT: 外国人居留证
IDENTIFICATION_TYPE_HONGKONG_MACAO_RESIDENT: 港澳居民证
IDENTIFICATION_TYPE_TAIWAN_RESIDENT: 台湾居民证

identification_name 　选填 string(2048)

【证件姓名】 1、请填写个体户经营者/法定代表人对应身份证的姓名，2~30个中文字符、英文字符、符号
2、该字段需进行加密处理，加密方法详见敏感信息加密说明
3、当收款账户为付款到对私银行卡时, 必填

identification_no 　选填 string(2048)

【证件号码】 1、如果证件类型为身份证, 需填写为15位数字或17位数字+1位数字|X ，该字段需进行加密处理，加密方法详见敏感信息加密说明
2、当收款账户为付款到对私银行卡时, 必填

proof_medias 　选填 array[ProofMedia]

【付款申请材料】填写条件：
主体为企业，且经营证照注吊撤，必填；
主体为事业单位/政府机关/社会组织，必填；
其他主体类型的商户，即主体为小微商户/个体工商户/经营证照存续的企业，无需填写

属性

proof_media_type 　必填 string

【付款申请材料类型】付款申请材料类型

可选取值

WITHDRAWAL_APPLICATION: 模版下载

proof_media 　必填 string(1024)

【证明材料照片】 1、请上传材料对应类型的图片
2、可上传1张图片，请填写通过图片上传接口预先上传图片生成好的MediaID

additional_materials 　选填 array[string]

【其他补充材料】不在上述证明材料中的其他需要服务商补充的，请填写通过图片上传接口预先上传图片生成好的MediaID，最多可上传10张图片

remark 　选填 string(1024)

【备注】付款申请备注，方便服务商备注特殊情况。为了提高审核效率，可在此字段描述“原出资商户主体是否已注销”或其他情况

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/ecommerce/account/apply-cancel-withdraw \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Wechatpay-Serial: 5157F09EFDC096DE15EBE81A47057A7232F1B8E1"  \
6  -H "Content-Type: application/json" \
7  -d '{
8    "sub_mchid" : "1900000109",
9    "out_request_no" : "P202410241010125346",
10    "withdraw" : "NOT_APPLY_WITHDRAW",
11    "payee_info" : {
12      "account_type" : "ACCOUNT_TYPE_CORPORATE",
13      "bank_account_info" : {
14        "account_name" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
15        "account_bank" : "工商银行",
16        "bank_branch_id" : "402713354941",
17        "bank_branch_name" : "施秉县农村信用合作联社城关信用社",
18        "account_number" : "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w=="
19      },
20      "identity_info" : {
21        "id_doc_type" : "IDENTIFICATION_TYPE_ID_CARD",
22        "identification_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
23        "identification_no" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw=="
24      }
25    },
26    "proof_medias" : [
27      {
28        "proof_media_type" : "WITHDRAWAL_APPLICATION",
29        "proof_media" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"
30      }
31    ],
32    "additional_materials" : [
33      "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"
34    ],
35    "remark" : "特殊理由"
36  }'
37

应答参数

200 OK

applyment_id 　选填 string(32)

【微信支付注销提现申请单号】电商平台提交二级商户注销提现申请后，由微信支付返回的申请单号，作为查询申请状态的唯一标识

out_request_no 　选填 string(32)

【商户注销申请单号】商户注销申请单号，由商户自定义生成，需要全局唯一

应答示例

200 OK

1{
2  "applyment_id" : "X202410241010125346",
3  "out_request_no" : "P202410241010125346"
4}
5

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	请根据错误提示正确传入参数
400	INVALID_REQUEST	HTTP 请求不符合微信支付 APIv3 接口规则	请参阅接口规则
401	SIGN_ERROR	验证不通过	请参阅签名常见问题
500	SYSTEM_ERROR	系统异常，请稍后重试	请稍后重试

业务错误码

状态码	错误码	描述	解决方案
400	BIZ_ERR_NEED_RETRY	系统异常，请求稍后重试	请稍后重试
400	ALREADY_EXISTS	out_request_no已使用	更换out_request_no重试

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服