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

更新时间: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: 收款人身份证正反面照片


 proof_media  必填   string(1024)

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


 additional_materials  选填   object

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

属性

 additional_media  选填   array[string]

【补充材料照片】最多可上传10张图片,请填写通过图片上传接口预先上传图片生成好的MediaID


 remark  选填   string(1024)

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

请求示例

curl
Java
Go

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

频率限制

请降低频率后重试

 

 

元宝AI
反馈
目录
置顶