查询结算资金

更新时间：2025.02.20

通过此接口可以查询结算资金的明细。

接口说明

适用对象: 直连模式机构模式

请求URL:https://apihk.mch.weixin.qq.com/pay/settlementquery

请求方式: POST

是否需要证书: 否

请求参数

参数名	变量	类型	必填	描述
公众账号ID	appid	string(32)	是	微信分配的公众账号ID（企业号corpid即为此appId）示例值：wxd678efh567hg6787
商户号	mch_id	string(32)	是	微信支付分配的商户号示例值：1900000109
子商户号	sub_mch_id	string(32)	否	子商户，填写微信支付分配的商户号若商户是直连商户、机构/银行服务商，无需填写该字段若商户是普通服务商商户，需要填写该字段示例值：1230000109
结算状态	usetag	int	是	已结算查询还是未结算查询 1 - 已结算查询 2 - 未结算查询示例值：1
随机字符串	nonce_str	string(32)	是	随机字符串，不长于32位。推荐随机数生成算法示例值：C380BEC2BFD727A4B6845133519F3AD6
偏移量	offset	int	是	返回的查询结果从这个偏移量开始取记录示例值：0
最大记录条数	limit	int	是	返回的最大记录条数，一般不超过10条为佳。示例值：10
开始日期	date_start	string(14)	是	格式为yyyyMMdd，如2009年12月25日表示为20091225。时区为GMT+8 beijing(查询未结算记录时，该字段可不传) 示例值：20150807
结束日期	date_end	string(14)	是	格式为yyyyMMdd，如2009年12月25日表示为20091225。时区为GMT+8 beijing（查询未结算记录时，该字段可不传) 示例值：20150807
是否查询分账结算信息	query_split	bool	否	已开通分账权限的商户，若query_split为true，返回信息中会增加分账结算字段；非分账商户无需关注该字段。示例值：true
签名	sign	string(64)	是	签名，详见签名生成算法示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS

举例如下：

1<xml>
2   <appid>wx2421b1c4370ec43b</appid>  
3   <mch_id>10000100</mch_id>
4   <usetag>1</usetag>
5   <nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
6   <offset>1</offset>
7   <limit>10</limit>
8   <date_start>20150807</date_start>
9   <date_end>20150807</date_end>
10   <query_split>true</query_split>
11   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
12</xml>

返回结果

字段名	变量	类型	必填	描述
返回状态码	return_code	string(16)	是	SUCCESS/FAIL 此字段是通信标识，非交易标识，交易是否成功需要查看trade_state来判断示例值：SUCCESS
返回信息	return_msg	string(128)	是	返回信息，如非空，为错误原因签名失败参数格式校验错误示例值：签名失败

以下字段在return_code为SUCCESS的时候有返回

字段名	变量	类型	必填	描述
公众账号ID	appid	string(32)	是	微信分配的公众账号ID 示例值：wxd678efh567hg6787
商户号	mch_id	string(32)	是	微信支付分配的商户号示例值：1230000109
随机字符串	nonce_str	string(32)	是	随机字符串，不长于32位。推荐随机数生成算法示例值：5K8264ILTKCH16CQ2502SI8ZNMTM67VS
业务结果	result_code	string(16)	是	SUCCESS/FAIL 示例值：SUCCESS
错误代码	err_code	string(32)	否	详细参见错误列表示例值：SYSTEMERROR
错误代码描述	err_code_des	string(128)	否	结果信息描述示例值：系统错误
返回数据行数	record_num	string(10)	是	返回数据行数示例值：10

以下字段在return_code 和result_code都为SUCCESS的时候有返回，如有多条记录，则以下数据会重复多组

字段名	变量	类型	必填	描述
付汇批次号	fbatchno	string(32)	是	微信返回的付款批次号示例值：10
结算日期	date_settlement	string(14)	是	格式为yyyyMMdd，如2009年12月25日表示为20091225。时区为GMT+8 beijing 示例值：20151101
交易开始日期	date_start	string(14)	是	格式为yyyyMMdd，如2009年12月25日表示为20091225。时区为GMT+8 beijing 示例值：20151101
交易结束日期	date_end	string(14)	是	格式为yyyyMMdd，如2009年12月25日表示为20091225。时区为GMT+8 beijing 示例值：20151101
划账金额	settlement_fee	int	是	外币标价，外币最小单位示例值：1
未划账金额	unsettlement_fee	int	是	外币标价，外币最小单位示例值：1
结算币种	settlementfee_type	string(8)	是	标价币种，符合ISO 4217标准的三位字母代码，详见标价币种注：退款币种与支付币种必须一致示例值：GBP
支付金额	pay_fee	int	是	该结算周期内会发生结算的交易总金额示例值：1
退款金额	refund_fee	int	是	该结算周期内退款总金额示例值：1
支付净额	pay_net_fee	int	是	该结算周期交易与退款总金额之差示例值：1
手续费金额	poundage_fee	int	是	手续费金额示例值：1
分账划账金额	split_settlement_fee	int	否	外币标价，外币最小单位。满足[商户开通分账权限]且[query_split=true]且[usetag=1]时，返回该信息示例值：1
分账未划账金额	split_unsettlement_fee	int	否	外币标价，外币最小单位。满足[商户开通分账权限]且[query_split=true]且[usetag=2]时，返回该信息。示例值：1

举例如下：

1<xml>
2   <return_code>SUCCESS</return_code>  
3   <result_code>SUCCESS</result_code>
4   <appid>wx2421b1c4370ec43b</appid>
5   <mch_id>10000100</mch_id>
6   <record_num>10</record_num>
7   <nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
8   <fbatchno>10</fbatchno>
9   <date_settlement>20150807</date_settlement>
10   <date_start>20150807</date_start>
11   <date_end>20150807</date_end>
12   <sign>BDF0099C15FF7BC6B1585FBB110AB635</sign>
13   <settlement_fee>1000</settlement_fee>
14   <unsettlement_fee>0</unsettlement_fee>
15   <settlement_type>USD</settlement_type>
16   <pay_fee>1000</pay_fee>
17   <refund_fee>0</refund_fee>
18   <pay_net_fee>1000</pay_net_fee>
19   <poundage_fee>0</poundage_fee>
20   <split_settlement_fee>1</split_settlement_fee>
21   <split_unsettlement_fee>1</split_unsettlement_fee>
22</xml>