接口說(shuō)明

適用對(duì)象:直連模式機(jī)構(gòu)模式

請(qǐng)求URL: https://api.mch.weixin.qq.com/hk/v3/statements

請(qǐng)求方式: GET

接口規(guī)則: https://wechatpay-api.gitbook.io/wechatpay-api-v3

path 指該參數(shù)需在請(qǐng)求URL傳參

query 指該參數(shù)需在請(qǐng)求JSON傳參

請(qǐng)求參數(shù)

請(qǐng)求示例：

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

    
｛
JAVA示例代碼
｝
    

返回參數(shù)

正常返回

成功時(shí)，數(shù)據(jù)以文本表格的方式返回，第一行為表頭，后面各行為對(duì)應(yīng)的字段內(nèi)容，字段內(nèi)容跟查詢訂單或退款結(jié)果一致，具體字段說(shuō)明可查閱相應(yīng)接口。

1）第一行為表頭，目前有：交易時(shí)間,公眾賬號(hào)ID,商戶號(hào),子商戶號(hào),設(shè)備號(hào),微信訂單號(hào),商戶訂單號(hào),用戶標(biāo)識(shí),交易類型,交易狀態(tài),付款銀行,充值券幣種,充值券金額,優(yōu)惠券幣種,優(yōu)惠券金額,微信退款單號(hào),商戶退款單號(hào),退款類型,退款狀態(tài),商品名稱,商戶數(shù)據(jù)包,手續(xù)費(fèi),費(fèi)率,標(biāo)價(jià)幣種,訂單金額（標(biāo)價(jià)幣種）,用戶支付幣種,用戶支付金額,結(jié)算幣種,應(yīng)結(jié)訂單金額,支付匯率,退款匯率,申請(qǐng)退款金額,用戶退款幣種,用戶退款金額,退款結(jié)算幣種,退款應(yīng)結(jié)訂單金額,充值券退款金額,優(yōu)惠券退款金額。

2）從第二行起，為數(shù)據(jù)記錄，各參數(shù)以逗號(hào)分隔，參數(shù)前增加`符號(hào)，為標(biāo)準(zhǔn)鍵盤1左邊鍵的字符，字段順序與表頭一致。

異常返回

返回示例：

{
      "code" : " NO_STATEMENT_EXIST",
      "message" : "賬單不存在"
    ｝

{
｛
      "code" : " NO_STATEMENT_EXIST",
      "message" : "賬單不存在"
    ｝
	

應(yīng)答簽名校驗(yàn)說(shuō)明

構(gòu)造簽名串

首先從應(yīng)答中獲取HTTP頭Wechatpay-Nonce中的應(yīng)答隨機(jī)串，Wechatpay-Timestamp中的應(yīng)答時(shí)間戳，Wechatpay-Statement-Sha1中取得賬單SHA1值。

請(qǐng)按照以下規(guī)則構(gòu)造應(yīng)答的簽名串。\n為換行符（ASCII編碼值為0x0A）。

應(yīng)答時(shí)間戳\n
應(yīng)答隨機(jī)串\n
賬單SHA1\n
\n

則簽名串為：

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

注意：標(biāo)紅的sha1值特殊處理為json格式進(jìn)行簽名

獲取應(yīng)答簽名

微信支付應(yīng)答簽名通過(guò)HTTP頭Wechat-Signature傳遞。（注意，示例因?yàn)榕虐婵赡艽嬖趽Q行，實(shí)際數(shù)據(jù)應(yīng)在一行）

Wechatpay-Signature: WcO+t3D8Kg71dTlKwN7r9PzUOXeaBJwp8/FOuSxcuSkXsoVYxBpsAidprySCjHCjmaglNcjoKJQLJ28/Asl93jo
TW39FX6i07lXhnbPknezAlwmvPdnQuI01HZsZF9V1i6ggZjBiAd5lG8bZtTxZOJ87ub2i9GuJ3Nr/NUc9VeY=，對(duì)Wechatpay-Signature的字段值使用Base64進(jìn)行解碼，得到應(yīng)答簽名。

驗(yàn)證簽名

很多編程語(yǔ)言的簽名驗(yàn)證函數(shù)支持對(duì)“簽名數(shù)據(jù)”進(jìn)行簽名驗(yàn)證。建議商戶調(diào)用該類函數(shù)，使用微信支付平臺(tái)公鑰對(duì)“簽名串”進(jìn)行SHA256 with RSA簽名驗(yàn)證。

如果商戶使用的編程語(yǔ)言或者庫(kù)只支持對(duì)“摘要數(shù)據(jù)”進(jìn)行簽名驗(yàn)證，請(qǐng)按照以下步驟驗(yàn)證簽名：

1.使用SHA256計(jì)算簽名串的摘要，得到摘要信息

2.使用微信支付平臺(tái)公鑰對(duì)摘要信息進(jìn)行RSA簽名驗(yàn)證（簽名類型為SHA256）。請(qǐng)參考OpenSSL的RSA_verify()

注意：微信支付證書序列號(hào)位于HTTP頭`Wechatpay-Serial`，驗(yàn)證簽名前請(qǐng)先檢查序列號(hào)是否跟商戶所持有的微信支付證書序列號(hào)一致。更新證書的說(shuō)明，請(qǐng)參考《獲取微信支付平臺(tái)證書》。

驗(yàn)證賬單完整性

賬單完整下載后，生成SHA1簽名與微信Wechatpay-Statement-Sha1值做賬單完整性的校驗(yàn)。

錯(cuò)誤碼