查询提现状态

更新时间：2025.04.07

场景介绍

小微商户模式下，与微信支付对接的是服务商，小微商户可能并不感知微信支付，小微商户的日常维护，是登录服务商自建的APP或者公众号，来查询提现状态等等。本API即提供自动提现查询能力给到服务商。

说明：

1、反映的是小微商户历史自动提现单据的相关信息；
2、资金账单中涉及金额的字段单位为“分”。

接口链接

https://api.mch.weixin.qq.com/fund/queryautowithdrawbydate

是否需要证书

需要。详见证书使用。

请求参数

字段名	变量名	必填	类型	示例值	描述
商户号	mch_id	是	String(32)	1900000109	微信支付分配的商户号
小微商户号	sub_mch_id	是	String(32)	1900000109	微信支付分配的商户号
签名	sign	是	String(64)	4219DA46A027E8C86DE1BE8CD252158B74DEFAA069CDB6DEFA235FFEA2437EA2	签名，详见签名生成算法
签名类型	sign_type	是	String(32)	HMAC-SHA256	签名类型，目前支持HMAC-SHA256。该字段需参与签名sign的计算。
日期	date	是	String(32)	20180508	格式：YYYYMMDD。要查询的提现单据的日期注意自动提现单是在交易次日汇总前一天的结算结果后生成，所以如果自动提现单日期是20180602，则对应的是20180601这天的交易。目前只支持查询最近30天的自动提现
随机字符串	nonce_str	是	String(32)	ibuaiVcKdpRxkhJA	随机字符串，不长于32位。推荐随机数生成算法

请求示例：

1<xml>
2   <nonce_str>ibuaiVcKdpRxkhJA</nonce_str>
3   <date>20180503</date>
4   <mch_id >2480029942</ mch_id >
5   <sub_mch_id>2480029752</ sub_mch_id >
6   <sign_type>HMAC-SHA256</sign_type>
7   <sign>1091442CB5E1D3B04DAC6CA9F42B50F74428727968FE2E570DE271030F16CCA8</sign>
8</xml>

返回结果

字段名	变量名	必填	类型	示例值	描述
返回状态码	return_code	是	String(16)	FAIL/SUCCESS	SUCCESS/FAIL 此字段是通信标识，非付款标识，付款查询是否成功需要查看result_code来判断
返回信息	return_msg	否	String(128)	OK	返回信息状态

当return_code为SUCCESS时，进一步返回以下字段

业务结果	result_code	是	string(16)	FAIL SUCCESS	此字段是业务标识，表示业务是否成功。目前只有SUCCESS和FAIL两种
错误代码	err_code	是	String(16)	SYSTEMERROR	见错误码列表
错误代码描述	err_code_des	否	String(128)	参数签名错误	错误信息描述
签名类型	sign_type	否	String(32)	HMAC-SHA256	签名类型，目前支持HMAC-SHA256
签名	sign	否	String(64)	4219DA46A027E8C86DE1BE8CD252158B74DEFAA069CDB6DEFA235FFEA2437EA2	签名，详见签名生成算法

当return_code和result_code都为SUCCESS的时候，还会包含以下字段

日期	date	是	String(32)	20180508	日期
商户号	mch_id	是	String(32)	1900000109	微信支付分配的商户号
小微商户号	sub_mch_id	是	String(32)	1900000109	微信支付分配的商户号
随机字符	nonce_str	是	String(32)	ibuaiVcKdpRxkhJA	随机字符串(与请求一致)
单据状态	withdraw_status	是	String(32)	PROCESSING	见单据状态描述
单据失败原因	fail_reason	否	String(64)		错误原因描述
提现单单据ID	withdraw_id	否	String(32)	10900999991802018050300326172000	如果该日存在提现单据，则表示提现单据的ID
金额	amount	否	int(32)	550	分（RMB）
单据创建时间	create_time	否	String(32)	2018-05-11 08:00:00	时间格式为YYYY-MM-ddHH:mm:ss
单据成功时间	success_time	否	String(32)	2018-05-11 08:00:00	时间格式为YYYY-MM-ddHH:mm:ss
单据退票时间	refund_time	否	String(32)	2018-05-11 08:00:00	时间格式为YYYY-MM-ddHH:mm:ss

成功示例：

1<xml>
2<return_code><![CDATA[SUCCESS]]></return_code>
3<return_msg><![CDATA[OK]]></return_msg>
4<result_code><![CDATA[SUCCESS]]></result_code>
5<err_code><![CDATA[SUCCESS]]></err_code>
6<err_msg><![CDATA[success]]></err_msg>
7<date>20180602</date>
8<mch_id><![CDATA[2480029942]]></mch_id>
9<sub_mch_id><![CDATA[2480029752]]></sub_mch_id>
10<withdraw_id><![CDATA[10900999991802018060200326172006]]></withdraw_id>
11<amount>445</amount>
12<create_time><![CDATA[2018-06-04 11:44:59]]></create_time>
13<nonce_str><![CDATA[ibuaiVcKdpRxkhJA]]></nonce_str>
14<sign_type><![CDATA[HMAC-SHA256]]></sign_type>
15<sign><![CDATA[8ADACE9EE2A39C20F56D115794AD8D1D91B636A12346766713D741E847B77BF5]]></sign>
16<withdraw_status><![CDATA[PROCESSING]]></withdraw_status>
17</xml>

失败示例：

1<xml>
2<return_code><![CDATA[SUCCESS]]></return_code>
3<return_msg><![CDATA[OK]]></return_msg>
4<result_code><![CDATA[FAIL]]></result_code>
5<err_code><![CDATA[CA_ERROR]]></err_code>
6<err_code_des><![CDATA[证书验证失败]]></err_code_des>
7</xml>

错误码

错误码	描述	解决方案
SYSTEM_ERROR	微信支付系统无明确返回结果	系统繁忙，请稍后重试
PARAM_ERROR	参数错误	请对照文档的请求参数说明检查参数
INVALID_REQUEST	获取输入信息失败	检查请求串，确认无误后重试
CA_ERROR	商户证书验证失败	到商户平台下载证书，请求带上证书后重试。
FREQUENCY_LIMITED	访问API超过限频	请降低访问频率
NO_AUTH	无接口访问权限	请联系运营人员
SUCCESS	成功	无

单据状态描述

单据状态枚举	描述	解决方案
PROCESSING	提现处理中	无，请耐心等待提现操作操作完成
SUCCESS	提现操作成功	无
REFUNDED	银行处理失败，提现操作退票	请确认商户结算银行卡信息后再重新发起提现
SUPPORT_RE_WITHDRAW	可重新发起提现	该日自动提现失败，可重新发起当日自动提现
SUPPORT_WITHDRAW	当日无提现单，并且当日净交易额大于0，因此支持发起该日自动提现	可发起当日自动提现
NOT_SUPPORT_WITHDRAW	当日距今超过30天；或当日无提现单，并且当日净交易额不大于0，因此不支持发起该日自动提现	无
NO_WITHDRAW_AUTH	商户无提现权限	联系运营人员

注意：

XML具有可扩展性，因此返回参数可能会有新增，而且顺序可能不完全遵循此文档规范，如果在解析回包的时候发生错误，请商户联系客服确认情况。如果有新回包字段，会更新到此API文档中。
因为错误代码字段err_code的值后续可能会增加，所以商户如果遇到回包返回新的错误码，请商户联系客服确认情况。如果有新的错误码，会更新到此API文档中。
错误代码描述字段err_code_des只供人工定位问题时做参考，系统实现时请不要依赖这个字段来做自动化处理。

文档是否有帮助

更多支持

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服