提交已注销商户号可用余额提现申请单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头参数
  • Authorization 必填 string
    请参考 签名认证 生成认证信息
  • Accept 必填 string
    请设置为 application/json
  • Content-Type 必填 string
    请设置为 application/json
  • Wechatpay-Serial 必填 string
    【微信支付平台证书序列号】 请求参数中的敏感字段,需要使用微信支付平台证书公钥加密。请设置为该证书的证书序列号。详见敏感信息加解密
    Body 包体参数
  • sub_mchid 必填 string(32)
    【二级商户号】 资金出款电商平台二级商户号。即电商平台二级商户号,由微信支付生成并下发。调用该提现接口前,会要求该二级商户号已注销
  • out_account_type 必填 string
    【二级商户号的出款子账户类型】 根据实际的出款子账户选择
    可选取值:
    • BASIC_ACCOUNT: 商户的基本户
    • OPERATE_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 必填 PayeeInfo
    【收款账号信息】 实际的收款账号
    • 属性
  • proof_media_list 选填 ProofPayeeMediaInfo
    【付款申请证明材料】 各类证明材料, 填写规则
    • 属性
  • additional_materials 选填 AdditionalMediaInfo
    【补充材料】 1、不在上述证明材料中的其他需要服务商补充的,请填写通过图片上传接口预先上传图片生成好的MediaID
    • 属性
  • remark 选填 string(1024)
    【备注】 付款申请备注,方便服务商备注特殊情况。为了提高审核效率,可在此字段描述“原出资商户主体是否已注销”或其他情况

请求示例

POST

# 应答参数

    200OK
  • applyment_id 选填 string(32)
    【微信支付提现申请单号】 电商平台提交二级商户可用余额提现申请后,由微信支付返回的申请单号,作为查询申请状态的唯一标识。
  • out_request_no 选填 string(32)
    【商户提现申请单号】 商户预约提现单号,由商户自定义生成,需要全局唯一

应答示例

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 频率限制 请降低频率后重试
反馈
咨询
目录