提交已注销商户号可用余额提现申请单API
更新时间:2023.08.21针对被微信支付平台不收不付管控的电商子商户,如子商户账户内还有可用余额,且无法解脱(例如 营业执照注销吊销),则服务商可为子商户申请走注销提现的流程,将可用余额进行提现操作。在商户号注销后,电商平台可发起提现申请, 审批通过后, 将会按照指定的收款方式返回给商户
请仔细阅读以下注意事项:
◆ 当返回错误码为“SYSTEMERROR”时,请不要更换商户提现申请单号,一定要使用原商户提现申请单号重试,否则可能造成重复支付等资金风险。
◆ 提交时遇到任何错误,请商户务必不要换单重试,请商户调用查询提现申请单状态接口确认提现申请单单据的状态, 再决定是否要换单重试, 避免重复提现
◆ 请商户在自身的系统中合理设置付款频次并做好并发控制,防范错付风险。
◆ 因商户自身系统设置存在问题导致的资金损失,由商户自行承担。
# 接口说明
支持商户:
【普通服务商】
请求方式:
【POST】/v3/mch_operate/risk/withdrawl-apply
请求域名:
【主域名】
https://api.mch.weixin.qq.com
使用该域名将访问就近的接入点【备域名】
https://api2.mch.weixin.qq.com
使用该域名将访问异地的接入点 ,指引点击查看
# 请求参数
Header HTTP头参数
- sub_mchid 必填【二级商户号】 资金出款电商平台二级商户号。即电商平台二级商户号,由微信支付生成并下发。调用该提现接口前,会要求该二级商户号已注销
- out_account_type 必填【二级商户号的出款子账户类型】 根据实际的出款子账户选择
可选取值:BASIC_ACCOUNT
: 商户的基本户OPERATE_ACCOUNT
: 商户的运营账户
- amount 必填【提现金额】 单位:分,提现金额不能超过二级商户号出款子账户的余额
- out_request_no 必填【商户提现申请单号】 商户提现申请单号,由商户自定义生成,必须是字母数字
- payee_type 必填【收款对象类型】 根据实际的收款对象选择
可选取值:CONTRIBUTION_MERCHANT
: 出资商户号收款,即已注销商户号资金提现给商户自己,收款账号类型对公银行卡账户 或 对私银行卡账户SERVICE_PROVIDER_MERCHANT
: 电商平台收款,即已注销商户号资金提现给服务商,收款账号类型支持电商平台同名对公银行卡账户OTHER_MERCHANT
: 其他商户号收款,即已注销商户号资金提现给其他商户,其他商户即除电商平台自身或出资商户号以外的商户, 收款账号类型视商户号主体类型,可支持对公或对私银行卡账户INDIVIDUAL
: 个人收款,即已注销商户号资金提现给个人银行卡(例如 给“达人、主播”),收款账号类型支持对私银行卡账户
- payee_mchid 选填【收款对象对应的商户号】 当收款对象不为个人时必填。
payee_type为“SERVICE_PROVIDER_MERCHANT电商平台收款”,payee_mchid填写对应电商平台服务商商户号;
payee_type为“CONTRIBUTION_MERCHANT出资商户号收款”,payee_mchid填写对应二级子商户号;
payee_type为“OTHER_MERCHANT其他商户号收款”,payee_mchid填写对应其他第三方收款商户号; - payee_info 必填【收款账号信息】 实际的收款账号
- 属性
- proof_media_list 选填【付款申请证明材料】 各类证明材料, 填写规则
- 属性
- additional_materials 选填【补充材料】 1、不在上述证明材料中的其他需要服务商补充的,请填写通过图片上传
接口预先上传图片生成好的MediaID - 属性
- remark 选填【备注】 付款申请备注,方便服务商备注特殊情况。为了提高审核效率,可在此字段描述“原出资商户主体是否已注销”或其他情况
Body 包体参数
请求示例
POST
# 应答参数
- applyment_id 选填【微信支付提现申请单号】 电商平台提交二级商户可用余额提现申请后,由微信支付返回的申请单号,作为查询申请状态的唯一标识。
- out_request_no 选填【商户提现申请单号】 商户预约提现单号,由商户自定义生成,需要全局唯一
200OK
应答示例
200 OK
# 错误码
# 公共错误码
状态码 | 错误码 | 描述 | 解决方案 |
---|---|---|---|
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 | 频率限制 | 请降低频率后重试 |
文档是否有帮助