提交已注销商户号可用余额提现申请单

更新时间：2025.01.09

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

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

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

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

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

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

接口说明

支持商户：【平台商户】

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

请求域名：【主域名】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_account_type 　必填 string

【二级商户号的出款子账户类型】根据实际的出款子账户选择

可选取值：

BASIC_ACCOUNT: 商户的基本户
OPERATE_ACCOUNT: 商户的运营账户
MARGIN_ACCOUNT: 商户的保证金户

amount 　必填 integer

【提现金额】单位：分，提现金额不能超过二级商户号出款子账户的余额

out_request_no 　必填 string(32)

【商户提现申请单号】商户提现申请单号，由商户自定义生成，必须是字母数字

payee_type 　必填 string

【收款对象类型】根据实际的收款对象选择

可选取值：

CONTRIBUTION_MERCHANT: 出资商户号收款，即已注销商户号资金提现给商户自己，收款账号类型对公银行卡账户或对私银行卡账户

SERVICE_PROVIDER_MERCHANT: 电商平台收款，即已注销商户号资金提现给服务商，收款账号类型支持电商平台同名对公银行卡账户

OTHER_MERCHANT: 其他商户号收款，即已注销商户号资金提现给其他商户，其他商户即除电商平台自身或出资商户号以外的商户, 收款账号类型视商户号主体类型，可支持对公或对私银行卡账户

INDIVIDUAL: 个人收款，即已注销商户号资金提现给个人银行卡（例如给“达人、主播”），收款账号类型支持对私银行卡账户

payee_mchid 　选填 string(32)

【收款对象对应的商户号】当收款对象不为个人时必填。

payee_type为“SERVICE_PROVIDER_MERCHANT电商平台收款”，payee_mchid填写对应电商平台服务商商户号；

payee_type为“CONTRIBUTION_MERCHANT出资商户号收款”，payee_mchid填写对应二级子商户号；

payee_type为“OTHER_MERCHANT其他商户号收款”，payee_mchid填写对应其他第三方收款商户号；

payee_info 　必填 object

【收款账号信息】实际的收款账号

属性

account_type 　必填 string

【账户类型】payee_type为“CONTRIBUTION_MERCHANT出资商户号收款”，则支持“对公”与“对私”。对私户名会校验是否与法人姓名一致；对公账户户名如与商户号主体不一致，则会要求提供对应授权函

如payee_type为“SERVICE_PROVIDER_MERCHANT电商平台收款”，则仅支持“对公”，且要求户名与电商平台主体一致

如payee_type为“OTHER_MERCHANT其他商户号收款”，如商户号类型为企业类，仅支持“对公”，且要求户名与商户号主体一致；如商户号类型为个体户类，支持“对公”或“对私”，且对公户名需与商户号主体一致，对私户名需与商户号法人姓名一致

如payee_type为“INDIVIDUAL个人收款”，仅支持对私户，户名不做要求，但需要提供对应函件

可选取值：

ACCOUNT_TYPE_CORPORATE: 对公银行账户

ACCOUNT_TYPE_PERSONAL: 对私银行卡账户

bank_account_info 　必填 object

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

属性

account_name 　必填 string(2048)

【开户名称】如payee_type为“CONTRIBUTION_MERCHANT出资商户号收款”，则支持“对公”与“对私”。对私户名会校验是否与法人姓名一致；对公账户户名如与商户号主体不一致，则会要求提供对应授权函

如payee_type为“SERVICE_PROVIDER_MERCHANT电商平台收款”，则仅支持“对公”，且要求户名与电商平台主体一致

如payee_type为“OTHER_MERCHANT其他商户号收款”，如商户号类型为企业类，仅支持“对公”，且要求户名与商户号主体一致；如商户号类型为个体户类，支持“对公”或“对私”，且对公户名需与商户号主体一致，对私户名需与商户号法人姓名一致；

如payee_type为“INDIVIDUAL个人收款”，仅支持对私户，户名不做要求，但需要提供对应函件

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

account_bank 　必填 string(128)

【开户银行】详细参见开户银行对照表

bank_branch_id 　选填 string(128)

【开户银行联行号】1、17家直连银行无需填写，如为其他银行，则开户银行全称（含支行）和开户银行联行号二选一
2、详细参见开户银行全称（含支行）对照表

bank_name 　选填 string(128)

【开户银行全称（含支行）】1、17家直连银行无需填写，如为其他银行，则开户银行全称（含支行）和开户银行联行号二选一
2、需填写银行全称，如"深圳农村商业银行XXX支行"
详细参见开户银行全称（含支行）对照表

account_number 　必填 string(2048)

【银行账号】1、数字，长度遵循系统支持的卡号长度要求表
2、该字段需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引

identity_info 　选填 object

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

属性

id_doc_type 　选填 string

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

可选取值：

IDENTIFICATION_TYPE_IDCARD: 中国大陆居民-身份证

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、该字段需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引
3、当收款账户为付款到对私银行卡时, 必填

identification_no 　选填 string(2048)

【证件号码】1、如果证件类型为身份证, 需填写为15位数字或17位数字+1位数字|X ，该字段需要使用微信支付公钥加密（推荐），请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引，也可以使用微信支付平台证书公钥加密，参考获取平台证书序列号、平台证书加密敏感信息指引
2、当收款账户为付款到对私银行卡时, 必填

proof_media_list 　选填 object

【付款申请证明材料】各类证明材料, 填写规则

属性

proof_payee_media 　选填 array[object]

【申请证明材料】

属性

proof_media_type 　必填 string

【申请证明材料类型】各种证明材料

可选取值：

WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_1: 已废弃

WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_2: 已废弃

WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_3: 已废弃

WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_4: 已废弃

WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_5: 已废弃

MISSING_OFFICIAL_SEAL_LETTER: 已废弃

CERTIFICATE_OF_ACCOUNT_CANCELLATION: 已废弃

INDUSTRIAL_AND_COMMERCIAL_CANCELLATION_CERTIFICATE: 已废弃

BASIC_TRANSACTION_INFORMATION: 分账接收方与子商户的合作背景证明材料 (如合作协议)

LEGAL_ID_CARD: 法人身份证（或其他证件）正反面照片

ID_CARD: 经营负责人身份证（或其他证件）正反面照片

BUSINESS_LICENSE_PHOTO: 营业执照照片

PAYEE_ID_CARD: 收款人身份证正反面照片

WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_6: 附件6模板.pdf
WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_7: 附件7模板.pdf
WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_8:附件8模板.pdf

proof_media 　必填 string(1024)

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

additional_materials 　选填 object

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

	属性
	additional_media 　选填 array[string] 【补充材料照片】最多可上传10张图片，请填写通过图片上传接口预先上传图片生成好的MediaID

remark 　选填 string(1024)

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

请求示例

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/mch_operate/risk/withdrawl-apply \
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_account_type" : "BASIC_ACCOUNT",
10    "amount" : 101,
11    "out_request_no" : "2019061122222222122",
12    "payee_type" : "CONTRIBUTION_MERCHANT",
13    "payee_mchid" : "1900000109",
14    "payee_info" : {
15      "account_type" : "ACCOUNT_TYPE_CORPORATE",
16      "bank_account_info" : {
17        "account_name" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw==",
18        "account_bank" : "工商银行",
19        "bank_branch_id" : "402713354941",
20        "bank_name" : "施秉县农村信用合作联社城关信用社",
21        "account_number" : "d+xT+MQCvrLHUVDWv/8MR/dB7TkXM2YYZlokmXzFsWs35NXUot7C0NcxIrUF5FnxqCJHkNgKtxa6RxEYyba1+VBRLnqKG2fSy/Y5qDN08Ej9zHCwJjq52Wg1VG8MRugli9YMI1fI83KGBxhuXyemgS/hqFKsfYGiOkJqjTUpgY5VqjtL2N4l4z11T0ECB/aSyVXUysOFGLVfSrUxMPZy6jWWYGvT1+4P633f+R+ki1gT4WF/2KxZOYmli385ZgVhcR30mr4/G3HBcxi13zp7FnEeOsLlvBmI1PHN4C7Rsu3WL8sPndjXTd75kPkyjqnoMRrEEaYQE8ZRGYoeorwC+w=="
22      },
23      "identity_info" : {
24        "id_doc_type" : "IDENTIFICATION_TYPE_IDCARD",
25        "identification_name" : "pVd1HJ6zyvPedzGaV+X3qtmrq9bb9tPROvwia4ibL+F6mfjbzQIzfb3HHLEjZ4YiR/cJiCrZxnAqi+pjeKIEdkwzXRAI7FUhrfPK3SNjaBTEu9GmsugMIA9r3x887Q+ODuC8HH2nzAn7NGpE/e3yiHgWhk0ps5k5DP/2qIdGdONoDzZelrxCl/NWWNUyB93K9F+jC1JX2IMttdY+aQ6zBlw0xnOiNW6Hzy7UtC+xriudjD5APomty7/mYNxLMpRSvWKIjOv/69bDnuC4EL5Kz4jBHLiCyOb+tI0m2qhZ9evAM+Jv1z0NVa8MRtelw/wDa4SzfeespQO/0kjiwfqdfg==",
26        "identification_no" : "AOZdYGISxo4y44/UgZ69bdu9X+tfMUJ9dl+LetjM45/zMbrYu+wWZ8gn4CTdo+D/m9MrPg+V4sm73oxqdQu/hj7aWyDl4GQtPXVdaztB9jVbVZh3QFzV+BEmytMNQp9dt1uWJktlfdDdLR3AMWyMB377xd+m9bSr/ioDTzagEcGe+vLYiKrzcroQv3OR0p3ppFYoQ3IfYeU/04S4t9rNFL+kyblK2FCCqQ11NdbbHoCrJc7NV4oASq6ZFonjTtgjjgKsadIKHXtb3JZKGZjduGdtkRJJp0/0eow96uY1Pk7Rq79Jtt7+I8juwEc4P4TG5xzchG/5IL9DBd+Z0zZXkw=="
27      }
28    },
29    "proof_media_list" : {
30      "proof_payee_media" : [
31        {
32          "proof_media_type" : "WECHAT_PAY_WITHDRAWAL_APPLICATION_TYPE_1",
33          "proof_media" : "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"
34        }
35      ]
36    },
37    "additional_materials" : {
38      "additional_media" : [
39        "jTpGmxUX3FBWVQ5NJTZvlKX_gdU4cRz7z5NxpnFuAxhBTEO_PvWkfSCJ3zVIn001D8daLC-ehEuo0BJqRTvDujqhThn4ReFxikqJ5YW6zFQ"
40      ]
41    },
42    "remark" : "特殊理由"
43  }'
44

应答参数

200 OK

applyment_id 　选填 string(32)

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

out_request_no 　选填 string(32)

【商户提现申请单号】商户预约提现单号，由商户自定义生成，需要全局唯一

应答示例

200 OK

1{
2  "applyment_id" : "20220101332222",
3  "out_request_no" : "1234567"
4}
5

错误码

公共错误码

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

业务错误码

状态码	错误码	描述	解决方案
400	RESOURCE_ALREADY_EXISTS	重复提交, 商户的提现申请单号已经存在, 请调用查询状态接口检查	重复提交, 商户的提现申请单号已经存在, 请调用查询状态接口检查
403	NO_AUTH	商户暂无权限使用此功能	仅允许电商平台允许使用。
403	NOTENOUGH	二级商户号账户可用余额不足	二级商户号账户可用余额不足
429	FREQUENCY_LIMITED	频率限制	请降低频率后重试

文档是否有帮助

更多支持

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