# 概述

在微信支付APIV3的所有接口交互中，都需要對(duì)【接口請(qǐng)求】或【回調(diào)通知】進(jìn)行SHA256 with RSA算法簽名計(jì)算，保證支付安全；并且也強(qiáng)烈建議對(duì)【響應(yīng)】和【回調(diào)】進(jìn)行驗(yàn)簽（部分接口不需要響應(yīng)驗(yàn)簽），保證響應(yīng)數(shù)據(jù)來自微信支付且未經(jīng)第三方篡改。對(duì)于常見的APIv3接口簽名錯(cuò)誤的問題，提供【簽名驗(yàn)簽工具】，模擬微信支付進(jìn)行簽名驗(yàn)簽。

下面介紹工具詳細(xì)操作指引，協(xié)助你進(jìn)行簽名計(jì)算和簽名驗(yàn)證。

# 1. 如何下載簽名驗(yàn)簽工具

下載地址：下載簽名驗(yàn)簽工具 (opens new window)

1.1 打開時(shí)個(gè)別用戶可能會(huì)提示：找不到MSVCR120.dll文件，需要額外下載一下該文件，放置安裝目錄即可。

1.2 功能界面

# 2. 如何使用簽名驗(yàn)簽工具

微信支付在簽名計(jì)算和簽名驗(yàn)證中使用基于非對(duì)稱密鑰的SHA256-RSA的數(shù)字簽名算法，利用公鑰和私鑰的配對(duì)關(guān)系實(shí)現(xiàn)加密和解密。私鑰用于加密數(shù)據(jù)，公鑰用于解密數(shù)據(jù)。由于私鑰的私密性，只有私鑰的擁有者才能生成有效的簽名，確保了信息的完整性和來源的可靠性。

下面列舉了微信支付常見場(chǎng)景的簽名/驗(yàn)簽參數(shù)以及使用的證書：

# 3. 簽名驗(yàn)證示例

# 3.1 微信支付APIv3接口

# 3.1.1 驗(yàn)簽參數(shù)填寫

# 3.1.2 GET請(qǐng)求驗(yàn)證示例（通過商戶單號(hào)查詢訂單狀態(tài)）

1GET  https://api.mch.weixin.qq.com/v3/pay/transactions/out-trade-no/{out_trade_no}?mchid={mchid}

簽名驗(yàn)證示例：

# 3.1.3 非GET請(qǐng)求驗(yàn)證示例(以JSAPI下單接口為例)

請(qǐng)求微信支付APIv3接口時(shí)，簽名參數(shù)示例：

1POST  https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi

簽名驗(yàn)證示例：

# 3.2 調(diào)起收銀臺(tái)

# 3.2.1 驗(yàn)簽參數(shù)填寫

使用App支付、JSAPI支付和小程序支付時(shí)，下單成功后，需要對(duì)相關(guān)調(diào)起參數(shù)計(jì)算簽名，再通過JS SDK調(diào)起收銀臺(tái)。

調(diào)起收銀臺(tái)和請(qǐng)求APIv3接口時(shí)使用的簽名算法一致，主要的不同是需構(gòu)造出不同的簽名明文。

# 3.2.2 調(diào)起收銀臺(tái)驗(yàn)證示例（App支付）

簽名驗(yàn)證示例：

# 3.3 微信支付應(yīng)答/回調(diào)

由于用于消息加密的微信支付平臺(tái)證書私鑰僅為微信支付側(cè)所持有，商戶無法獨(dú)立創(chuàng)建消息以進(jìn)行回調(diào)驗(yàn)證測(cè)試。因此，商戶僅能通過實(shí)際的線上應(yīng)答/回調(diào)請(qǐng)求來獲取相應(yīng)參數(shù)以完成測(cè)試。

# 3.3.1 驗(yàn)簽參數(shù)填寫

# 3.3.2 微信通知回調(diào)驗(yàn)證示例（支付通知）

以某次支付成功后支付回調(diào)通知HTTP 報(bào)文為例：

請(qǐng)求頭

1Content-Length: 923
2Wechatpay-Nonce: D4PJYH8323444WUNiUs5O1jorgGif5ykEs
3Wechatpay-Signature: ZTp6+tGGBDoh+6dnG9fFQFStlBqgtqozfACJ2bwHKB6yRn0qIaIgWUcT72Ylhyjzh9c3nvTG2xbeSyY4TclAVbSz4z2aLnR6h0VBXhDxIqcuR+m1lVed9WcE0Yebb496gh7vctrRtJXTb+wZ6pdtqJ+Z/XqZn/rz7o16IQIxdHrBnIotkEzJ56stwPsrcuOf/dQOY3enkv3cfMSLRfMkto70xfzIYu+Hr7M5FIbSiMviIgPp+gvF4O0BsEXxSYTIuTQ4GISYlLplirv4tNVCqcZEB5Mb/vK0xWtO0oIEAPwA8Y5qqVAj6FPdPPaCxGqbdR6Qmvf55N+KRWisfA6RLQ==+p4VrmfWA8cRt3WiR+iOB/kSrWCbF+K2WhvhhWJSmrtaGy+5Sig3OSw+e+H38go6fc33ijr7p+l3xihMKSkU4r3YgluixXt/GVhxMCiFF5THj/VMyZuT4o3BE46eZpp7RMovEcNRpI6CF5TseuXa87P+u56Lk8yvqOB2+Qy3Nf0aiezbAktr/wXP4mMh0ceB1g5Yv2Hk5wzERM2dZwogzyncOMef0BeebTwadR/OxPlbr7HyI816SJdefQUIszdFXEOo3xgR8UnzyXXX6NU/mnreGVLnC9U3Or8Sc6g=
4Wechatpay-Timestamp: 1724231603
5Wechatpay-Serial: 5157F09EFDC960DE15EBE81A47057A7232F1B8E1
6Wechatpay-Signature-Type: WECHATPAY2-SHA256-RSA2048
7Connection: keep-alive
8Content-Type: application/json
9User-Agent: Mozilla/4.0

請(qǐng)求體

1{"id":"da2b8a7f-dad3-5f69-b5eb-2446b94543","create_time":"2024-08-16T15:00:03+08:00","resource_type":"encrypt-resource","event_type":"TRANSACTION.SUCCESS","summary":"支付成功","resource":{"original_type":"transaction","algorithm":"AEAD_AES_256_GCM","ciphertext":"Zkwzt1znCk78U2/xRl2ZVHlwaxcTg02MWN/36VW3cTFGJJWCDucckbqEPFCt5HIAwuhz1+oVbI1NJDqqmdfJAKSeZvDWivzgkLehZSI211qZhPruF8+/Oo8fuEmTigQo6BL1XUDUKSyegcYphyU+hFayU6gXAa7hatmbOr36dALy5Ijb+o6f+VDJ33A77lGgFP5xD1IhaqLkaYnDseBxot5bn3fwtASpNN176VKnKDb4co5E73kJzgtF3qPZTv40Nud0qakFHjs8h7NI7/hKKZVRL8wd3NHXLFfWGlq11GBjpH4Pm7OtZMifdHEa2pxZDiiYnAdO49cx1EMToN+0cdKv4dxWLxsy4wJhja44zaIfaViGSxbOojo1017C1eNQvfLraEqRnASvkilb/MQUPhLNM93PI1I20M6rrsKMNsF0U3IKYHvay+r9V+twrzXuHbgBWWVUtxVwvpIEzuPkJ756zRK5mf/XOLyotW4E42DBVgJZ+11OyTY8aSANWUl2G4zJoVlQJgHgNy0JNF2w0/7kU02o6fkDp81lOP7QU/4PeyzIqchDoqqhxKGOfMrun+V6/avn+tcZ2qIK+2etIZ4NwTun6G/Q2Cn8hRUwcXU28eWJvMrFeg==","associated_data":"transaction","nonce":"Oiyu5riw0HOJ"}}

驗(yàn)簽參數(shù)

簽名驗(yàn)證示例：

# 4 生成簽名示例

除了驗(yàn)簽，我們還可以通過簽名/驗(yàn)簽工具，直接生成對(duì)應(yīng)明文的簽名值。因?yàn)镾HA256和RSA的算法都是固定的，所以使用同樣的私鑰對(duì)同樣的明文（簽名串）計(jì)算后得到的簽名值是相同的。

1. 驗(yàn)證證書匹配關(guān)系。
   我們可以用私鑰簽名后生成簽名值，公鑰驗(yàn)簽，根據(jù)結(jié)果判斷使用的簽名證書apiclient_key.pem（私鑰）和驗(yàn)簽證書apiclient_cert.pem（公鑰）是否匹配，驗(yàn)證代碼計(jì)算簽名的過程是否正確。
2. 校驗(yàn)請(qǐng)求簽名的正確性。
   工具生成后的簽名值，可以用于直接去請(qǐng)求接口，調(diào)試校驗(yàn)自己代碼請(qǐng)求時(shí)使用的各參數(shù)和工具中計(jì)算簽名時(shí)使用的各參數(shù)是否一致。

# 4.1 驗(yàn)證證書匹配關(guān)系

對(duì)于有多套有效商戶API證書的商戶，請(qǐng)求接口時(shí)簽名私鑰文件apiclient_key.pem和證書序列號(hào)容易傳錯(cuò)，但是無法確定自己使用的是否為同一套公私鑰，可以使用該工具進(jìn)行驗(yàn)證。

也可使用 證書查看工具 (opens new window) 查看商戶API證書公鑰apiclient_cert.pem的證書序列號(hào)進(jìn)行輔助確認(rèn)。

# 4.2 校驗(yàn)請(qǐng)求簽名的正確性

您可以在工具上填入指定的參數(shù)，生成請(qǐng)求簽名，以及校驗(yàn)請(qǐng)求簽名的正確性。生成簽名示例參考 請(qǐng)求參數(shù)里帶Body參數(shù)(包體參數(shù)），如何計(jì)算簽名

1. 按接口規(guī)則構(gòu)建明文/驗(yàn)簽串，通過簽名/驗(yàn)簽工具用apiclient_key.pem私鑰證書生成簽名signature
2. 再根據(jù)Authorization的組成規(guī)則，結(jié)合驗(yàn)簽串的內(nèi)容和生成的signature，構(gòu)建一個(gè)Authorization字符串，可以直接使用Authorization去請(qǐng)求接口。