提交注销提现申请

更新时间: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 使用该域名将访问异地的接入点 ,指引点击查看

请求参数
折叠全部参数

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

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

属性

 account_name  必填   string(2048)

【开户名称】 1、选择对私银行账户时,开户名称必须与法人身份证姓名一致;
2、选择对公账户时,开户名称必须与营业执照上的“商户名称”一致。如不一致,需要填写补充资料字段;
3、该字段需要进行加密,可以选取任一方式加密:1)使用微信支付公钥加密(推荐使用),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,2)使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 account_bank  必填   string(128)

【开户银行】 请填写开户银行名称
对私银行调用:查询支持个人业务的银行列表API
对公银行调用:查询支持对公业务的银行列表API


 bank_branch_id  选填   string(128)

【开户银行联行号】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行,开户银行全称(含支行)和开户银行联行号二选一。
2、详细需调用查询支行列表API查看查询结果。


 bank_branch_name  选填   string(128)

【开户银行全称(含支行)】 1、根据开户银行查询接口中的“是否需要填写支行”判断是否需要填写。如为其他银行,开户银行全称(含支行)和开户银行联行号二选一。
2、详细需调用查询支行列表API查看查询结果。


 account_number  必填   string(2048)

【银行账号】 1、数字,长度遵循系统支持的开户银行对照表中对公/对私卡号长度要求
2、该字段需要进行加密,可以选取任一方式加密:1)使用微信支付公钥加密(推荐使用),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引,2)使用微信支付平台证书公钥加密,参考获取平台证书序列号平台证书加密敏感信息指引


 identity_info  选填   object

【收款人账号对应的证件信息】 当收款账户为付款到对私银行卡时,需要提供对私账户开户人的身份证件信息,必填, 以下id_doc_typeidentification_nameidentification_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

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

可选取值


 proof_media  必填   string(1024)

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


 additional_materials  选填   array[string]

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


 remark  选填   string(32)

【备注】 付款申请备注,传入后将展示在收款银行系统中,可供平台与二级商户进行对账。由数字、字母、汉字组成(能否成功展示依赖银行系统支持)。

请求示例

curl
Java
Go

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" : "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}

错误码

公共错误码

状态码

错误码

描述

解决方案

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重试

 

 

元宝AI
反馈
目录
置顶