适用对象:直连模式机构模式
请求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>
字段名 | 变量 | 类型 | 必填 | 描述 |
---|---|---|---|---|
返回状态码 | 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>
Customer Service Tel
Business Development
9:00-18:00
Monday-Friday GMT+8
Technical Support
WeChat Pay Global
ICP证