1. 接口说明

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

请求URL:https://apihk.mch.weixin.qq.com/v3/global/statements

请求方式: GET

2. 请求参数

请求示例

		https://apihk.mch.weixin.qq.com/v3/global/statements?date=20180130&mchid=1900000109
  

https://apihk.mch.weixin.qq.com/v3/global/statements?date=20180130&sp_mchid=1900000109
https://apihk.mch.weixin.qq.com/v3/global/statements?date=20180130&sp_mchid=1900000109&sub_mchid=1900000102
  

3. 返回参数

正常返回

成功时，数据以文本表格的方式返回，第一行为表头，后面各行为对应的字段内容，字段内容跟查询订单或退款结果一致，具体字段说明可查阅相应接口。

1）第一行为表头，目前有：交易时间,公众账号ID,商户号,子商户号,设备号,微信订单号,商户订单号,用户标识,交易类型,交易状态,付款银行,充值券币种,充值券金额,优惠券币种,优惠券金额,微信退款单号,商户退款单号,退款类型,退款状态,商品名称,商户数据包,手续费,费率,标价币种,订单金额（标价币种）,用户支付币种,用户支付金额,结算币种,应结订单金额,支付汇率,退款汇率,申请退款金额,用户退款币种,用户退款金额,退款结算币种,退款应结订单金额,充值券退款金额,优惠券退款金额。

2）从第二行起，为数据记录，各参数以逗号分隔，参数前增加`符号，为标准键盘1左边键的字符，字段顺序与表头一致。

异常返回

返回示例

{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "与ALLOF schema不符",
		"location": "body"
	}
}

{
	"code": "INVALID_REQUEST",
	"message": "Parameter format verification error",
	"detail": {
		"field": "#/properties/payer",
		"value": "1346177081915535577",
		"issue": "与ALLOF schema不符",
		"location": "body"
	}
}

4. 应答签名校验说明

4.1. 构造签名串

首先从应答中获取HTTP头Wechatpay-Nonce中的应答随机串，Wechatpay-Timestamp中的应答时间戳，Wechatpay-Statement-Sha1中取得账单SHA1值。

请按照以下规则构造应答的签名串。\n为换行符（ASCII编码值为0x0A）。

    应答时间戳\n
    应答随机串\n
    账单SHA1\n
    \n

则签名串为：

    1507709906
    5K8264ILTKch16CQ2502SI8ZNMTM67VS
    {"sha1" : "12345678999"}
    

注意

标红的sha1值特殊处理为json格式进行签名；签名串最后一行为空，即多一个换行符

4.2. 获取应答签名

微信支付应答签名通过HTTP头Wechat-Signature传递。（注意，示例因为排版可能存在换行，实际数据应在一行） Wechatpay-Signature: WcO+t3D8Kg71dTlKwN7r9PzUOXeaBJwp8/FOuSxcuSkXsoVYxBpsAidprySCjHCjmaglNcjoKJQLJ28/Asl93joTW39FX6i07lXhnbPknezAl wmvPdnQuI01HZsZF9V1i6ggZjBiAd5lG8bZtTxZOJ87ub2i9GuJ3Nr/NUc9VeY=，对Wechatpay-Signature的字段值使用Base64进行解码，得到应答签名。

4.3. 验证签名

很多编程语言的签名验证函数支持对“签名数据”进行签名验证。建议商户调用该类函数，使用微信支付平台公钥对“签名串”进行SHA256 with RSA签名验证。

如果商户使用的编程语言或者库只支持对“摘要数据”进行签名验证，请按照以下步骤验证签名：

1.使用SHA256计算签名串的摘要，得到摘要信息

2.使用微信支付平台公钥对摘要信息进行RSA签名验证（签名类型为SHA256）。请参考OpenSSL的RSA_verify()

注意

微信支付证书序列号位于HTTP头`Wechatpay-Serial`，验证签名前请先检查序列号是否跟商户所持有的微信支付证书序列号一致。更新证书的说明，请参考《获取微信支付平台证书》。

4.4. 验证账单完整性

账单完整下载后，生成SHA1签名与微信Wechatpay-Statement-Sha1值做账单完整性的校验。

5. 错误码