商户申请单号查询申请单状态

更新时间:2025.09.26

电商平台发起申请后, 电商平台调用此接口查询审批和出款进度

接口说明

支持商户:【平台商户】

请求方式:【GET】/v3/ecommerce/account/apply-cancel-withdraw/out-request-no/{out_request_no}

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


path  路径参数

 out_request_no  必填   string(32)

【商户注销申请单号】 由商户自定义生成的、在提交接口传入的单号

请求示例

curl
Java
Go

GET

1curl -X GET \
2  https://api.mch.weixin.qq.com/v3/ecommerce/account/apply-cancel-withdraw/out-request-no/P202410241010125346 \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" 
5

应答参数
折叠全部参数

200 OK

 applyment_id  必填   string(32)

【微信支付注销提现申请单号】 电商平台提交注销申请后,由微信支付返回的申请单号,作为查询申请状态的唯一标识。


 out_request_no  必填   string(32)

【商户注销申请单号】 商户注销申请单号,由商户自定义生成,需要全局唯一


 cancel_state  必填   string

【注销提现申请单状态】 发起注销提现申请后,整个流程可能流转的状态

可选取值

  • ACCEPTED:  已受理

  • REVIEWING:  审核中

  • REJECTED:  审批驳回

  • WAITING_MERCHANT_CONFIRM:  等待商户确认

  • REVOKED:  已撤销

  • SYSTEM_PROCESSING:  系统处理中

  • CANCELED:  已注销

  • FUND_PROCESSING:  资金处理中

  • FINISH:  注销完成


 cancel_state_description  必填   string(256)

【注销提现申请单状态描述】 注销提现申请单状态的文字描述


 withdraw  选填   string

【是否提取资金】 在提交接口传入的是否提取资金标记

可选取值

  • NOT_APPLY_WITHDRAW:  仅注销,不申请提现

  • APPLY_WITHDRAW:  申请提现


 withdraw_state  选填   string

【提现状态】 当申请单进入「资金处理中」状态时,返回此状态,反映资金提现的处理进度

可选取值

  • WITHDRAW_PROCESSING:  提现处理中

  • WITHDRAW_EXCEPTION:  提现异常

  • WITHDRAW_SUCCEED:  提现成功


 withdraw_state_description  选填   string(256)

【提现状态描述】 提现申请单状态的文字描述


 account_withdraw_result  选填   array[object]

【账户提现结果】 对具体账户发起提现操作后返回,商户已开通的账户参见account_info字段返回,微信支付注销提现流程会将商户账户里所有遗留的资金全额清退,请平台做好资金对账。多个账户存在资金时,将会有多笔提现金额,请注意核对银行入账流水

属性

 out_account_type  必填   string

【二级商户号的出款子账户类型】  仅返回已开通的账户类型

可选取值

  • BASIC_ACCOUNT:  商户的基本户

  • OPERATE_ACCOUNT:  商户的运营账户

  • MARGIN_ACCOUNT:  商户的保证金户

  • TRADE_FEE_ACCOUNT:  商户的手续费账户


 pay_state  必填   string

【付款状态】 付款状态

可选取值

  • PAY_PROCESSING:  处理中

  • PAY_SUCCEED:  付款成功

  • PAY_FAIL:  付款失败

  • BANK_REFUNDED:  银行退票


 state_description  必填   string(256)

【付款状态描述】 付款状态描述


 modify_time  选填   string(32)

【最后更新时间】 遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE,yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头,HH:mm:ss表示时分秒,TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。例如:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日 13点29分35秒。


 sub_mchid  必填   string(32)

【申请注销的二级商户号】 平台商户的二级商户号,由微信支付生成并下发


 account_info  选填   array[object]

【账户信息】二级商户号已开通的账户信息,仅涉及提取资金类的申请单返回,单据受理及后续状态返回

属性

 out_account_type  必填   string

【二级商户号的出款子账户类型】 仅返回已开通的账户类型

可选取值

  • BASIC_ACCOUNT:  商户的基本户

  • OPERATE_ACCOUNT:  商户的运营账户

  • MARGIN_ACCOUNT:  商户的保证金户

  • TRADE_FEE_ACCOUNT:  商户的手续费账户


 amount  必填   integer

【账户金额】 单位:分


 confirm_cancel  选填   object

【用于引导商户超级管理员确认注销的信息】 当注销提现申请单状态变更为WAITING_MERCHANT_CONFIRM(等待商户确认)时,查单接口会返回此字段组。此时可将对应url转化为二维码,引导商户号员工扫码确认注销。

属性

 confirm_cancel_url  选填   string(1024)

【确认商户注销的页面url】 确认商户注销的页面url,推荐:把url转为二维码,邀请被注销商户的员工使用微信扫描二维码访问,确认注销商户。

应答示例

200 OK

1{
2  "applyment_id" : "X202410241010125346",
3  "out_request_no" : "P202410241010125346",
4  "cancel_state" : "FUND_PROCESSING",
5  "cancel_state_description" : "资金处理中",
6  "withdraw" : "APPLY_WITHDRAW",
7  "withdraw_state" : "WITHDRAW_PROCESSING",
8  "withdraw_state_description" : "提现处理中",
9  "account_withdraw_result" : [
10    {
11      "out_account_type" : "BASIC_ACCOUNT",
12      "pay_state" : "PAY_SUCCEED",
13      "state_description" : "付款成功"
14    }
15  ],
16  "modify_time" : "2015-05-20T13:29:35+08:00",
17  "sub_mchid" : "1900000109",
18  "account_info" : [
19    {
20      "out_account_type" : "BASIC_ACCOUNT",
21      "amount" : 101
22    }
23  ],
24  "confirm_cancel" : {
25    "confirm_cancel_url" : "https://pay.weixin.qq.com/some_page?param_name=param_value"
26  }
27}
28

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

 

元宝AI
反馈
目录
置顶