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

更新时间:2025.03.13

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

接口说明

支持商户:【平台商户】

请求方式:【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)

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

请求示例

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: 已注销

  • 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]

【账户提现结果】 账户提现结果

属性

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]

【账户信息】 账户信息

属性

应答示例

200 OK

1{
2  "applyment_id" : "X202410241010125346",
3  "out_request_no" : "P202410241010125346",
4  "cancel_state" : "ACCEPTED",
5  "cancel_state_description" : "已注销",
6  "withdraw" : "NOT_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_PROCESSING",
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}
25

 

错误码

公共错误码

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

 

更多技术问题
技术咨询
反馈
咨询
目录
置顶