微信支付-跨境支付开发者文档

返回上一层跨境支付 / 小程序支付 / 查询结算资金API

查询结算资金

最新更新时间：2022.6.08 版本说明

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

接口说明

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

请求URL:https://api.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)	否	子商户，填写微信支付分配的商户号 1. 若商户是直连商户、机构/银行服务商，无需填写该字段 2. 若商户是普通服务商商户，需要填写该字段示例值：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

举例如下：


<xml>
   <appid>wx2421b1c4370ec43b</appid>  
   <mch_id>10000100</mch_id>
   <usetag>1</usetag>
   <nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
   <offset>1</offset>
   <limit>10</limit>
   <date_start>20150807</date_start>
   <date_end>20150807</date_end>
   <query_split>true</query_split>
   <sign>FDD167FAA73459FD921B144BAF4F4CA2</sign>
</xml>

    
｛
JAVA示例代码
｝

返回结果

字段名	变量	类型	必填	描述
返回状态码	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

举例如下：


<xml>
   <return_code>SUCCESS</return_code>  
   <result_code>SUCCESS</result_code>
   <appid>wx2421b1c4370ec43b</appid>
   <mch_id>10000100</mch_id>
   <record_num>10</record_num>
   <nonce_str>ec2316275641faa3aacf3cc599e8730f</nonce_str>
   <fbatchno>10</fbatchno>
   <date_settlement>20150807</date_settlement>
   <date_start>20150807</date_start>
   <date_end>20150807</date_end>
   <sign>BDF0099C15FF7BC6B1585FBB110AB635</sign>
   <settlement_fee>1000</settlement_fee>
   <unsettlement_fee>0</unsettlement_fee>
   <settlement_type>USD</settlement_type>
   <pay_fee>1000</pay_fee>
   <refund_fee>0</refund_fee>
   <pay_net_fee>1000</pay_net_fee>
   <poundage_fee>0</poundage_fee>
   <split_settlement_fee>1</split_settlement_fee>
   <split_unsettlement_fee>1</split_unsettlement_fee>
</xml>

WeChat Pay

Feedback

Feedback

Submitted successfully

Feedback

Network exception, please try again later

小程序支付

查询结算资金

接口说明

请求参数

举例如下：

返回结果

举例如下：

版本说明