為了方便大家理解，我們將使用測試的一對公私鑰，通過命令行形式調(diào)用"查詢單筆退款（通過商戶退款單號） (opens new window)"接口，一步一步介紹請求參數(shù)里帶Path參數(shù)（路徑參數(shù)），如何計算簽名。強烈建議你使用測試的公私鑰，按照本文實際操作一下，如果算出來的簽名和文檔的一致則說明計算無誤。實際業(yè)務(wù)中請?zhí)鎿Q為你的真實的參數(shù)。
以查詢單筆退款（通過商戶退款單號）為例，路徑參數(shù)需要需要替換成你真實的值，我們將以以下示例演示如何計算簽名
1https://api.mch.weixin.qq.com/v3/refund/domestic/refunds/123123123123
# 1. 準備
商戶需要擁有一個微信支付商戶號，并通過超級管理員賬號登錄商戶平臺，獲取商戶API證書，可以參考如何獲取商戶API證書 (opens new window)。 商戶申請商戶 API 證書時，證書工具會生成商戶私鑰，并保存在本地證書文件夾的文件 apiclient_key.pem 中。私鑰也可通過工具從商戶的 p12 證書中導(dǎo)出。請妥善保管好商戶私鑰文件。請注意計算簽名需要用到的是商戶API證書而不是平臺證書，請不要搞混。
商戶號：1900007291
證書序列號：408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB
API證書私鑰：你需要將以下文件保存為pem格式，為了避免大家和自己的真實的公私鑰混淆，此處將其保存為了apiclient_test_key.pem，這只是一個示例密鑰，實際上并不可用
-----BEGIN RSA PRIVATE KEY-----
MIIEogIBAAKCAQEAptpm+qvIDCh/9wjU26SQCK26ogYkBhDrYxnAaw2JbbBsp1oD
bHKk+1r381NeBUG2HEFAuU+Fr72u5ot3yKdzoF/FajAzQNKnm569/D3upKoi8mYB
aST15Uig8j8qoUW1U217LL0jEHlSnHV3lcaDTXqDpTRR4Bfz9IqOgJgFZ8/oTfEo
mSrjrLYef81Eyxr7ZIMQXEKKEK7V4UXKS0+/fDsiG/cXidhzt8UbTL9vqXqxM2+I
DImyO+FAc/tkBG55LmzxPto1Nq0WbnZzRM/wTzrd0I/8NlevxtFbphg4evlHjFNI
7+GrqR87ViEwuAJJ9Je5QQjct5YJfFRWiZ5CMQIDAQABAoIBAGBi/GhEgezcHIg1
ltlHaFlLGuxsRbUnYwM9phVxnXk7GJlYe2/TjpERjPkIqOC6hBwwadZjJORP3FCc
Mtc8PKRhjuZ377O7vU0915x2nnyLOGL1IE2AJ3iLi0ZFzTea0FPgg+5lWHM00s9F
YI6qPcGtS41M+xtMWwZiYE3TBBRibHiY8ugGyaNAhiMKehyW05uApjlIF55wwCGx
BkyESJpGRR/6853iHke6Ge+xVcMa9QmQdoH0QqL/8kT28PL568mJJr0Ow/83t4+d
Pe70YPzKAxgUnaDsHJqO+b8qH69AEs8rTI5h2Mon6pH+bJT66KUoiXhn+Kf+4LSs
henRP10CgYEA1QJSfuFOWVRjrg3N/rAIc/Ak84BTZavbyrkqBSuoTs9i/nMI/hOz
VxpDntg7Bx2Tctl6sZO3GioTxKdc/YYaTKci1TKBbeginpsqEQVgwkMCy8HpvUmR
fyAMqLwZC4h9+j+NiZtuoFJDTCgv+WYbasX+kWYEUM21bnSYuO7yEQsCgYEAyIdP
r9uzqPgzN34Tmx+CNTa16VjhBh+zkBtXRLDLhWBeIYxoYNJARD98Pb1XZdvpkZZW
Sk7MfaKo2/DomzyyyB/MbHWwAdFi3yb4y7uMJfyC1MzdUSNN3Vp579hJxHkJ+nN4
Ys76yfcEeVOLnvUT1Z0KKCdIWRdT1Lgi+X1itzMCgYBJUXlPzwGG4fNFj97d0X23
Wmt9nSgXkOYgi0eZbAOMzPmIF9R6kBFk49dur4Lx2g5Ms+r1gKC/0sfnIqxxX11i
EQ1+UNoYGJUB/uql3TIG68XkmKR50P7RwRhaZBRC0gJ6xrFTMjsL2ATuC88niyvY
vrn3FiRaI9RVZrDCxwxvLQKBgEXW4okEAqGBuAzGqztmkOnJoTehDdYdKmOxMgap
cGiGdKJIjX3THDDoz3ONQyglnEZpTqpYoV3MTfU0BT8zt6x9bqwDnQY1D7NalmIW
cqw0Mri8lQQSQKcsQLWo5aA466G/n5kCL1Qx5OwAjesRvhOyuvvbGpZ0ymyWqQ+t
fLkDAoGATcul1L8y5D/wNVP1GXbXMZfBsFP3bbqy8c+Ashm6g8OLm2mGNntd5Z6h
1KkID7Yksh+dZ6t7XaPBtGACXX5Eryr537JVvdX8hAVCp5HVtaN/9VBVP8Ka2e4s
VS/xeNgOMQ7uzhRPBJ8HiTmdI1nHhDnYQpGiBgQn0Z5RAkSvFMk=
-----END RSA PRIVATE KEY-----
# 2. 構(gòu)造簽名串
我們希望商戶的技術(shù)開發(fā)人員按照當(dāng)前文檔約定的規(guī)則構(gòu)造簽名串。微信支付會使用同樣的方式構(gòu)造簽名串。如果商戶構(gòu)造簽名串的方式錯誤，將導(dǎo)致簽名驗證不通過。下面先說明簽名串的具體格式。
簽名串一共有五行，每一行為一個參數(shù)。結(jié)尾以\n（換行符，ASCII編碼值為0x0A）結(jié)束，包括最后一行。如果參數(shù)本身以\n結(jié)束，也需要附加一個\n。
1HTTP請求方法\n2URL\n3請求時間戳\n4請求隨機串\n5請求報文主體\n以查詢單筆退款（通過商戶退款單號）接口為例，
第一步，獲取HTTP請求的方法
1GET第二步，獲取請求的絕對URL，查詢單筆退款（通過商戶退款單號）接口的URL
為/v3/refund/domestic/refunds/{out_refund_no}，path里面帶了參數(shù)out_refund_no，這里需要填上實際的商戶退款單號，例如123123123123
1/v3/refund/domestic/refunds/123123123123第三步，獲取發(fā)起請求時的系統(tǒng)當(dāng)前時間戳，即格林威治時間1970年01月01日00時00分00秒(北京時間1970年01月01日08時00分00秒)起至現(xiàn)在的總秒數(shù)，作為請求時間戳。微信支付會拒絕處理很久之前發(fā)起的請求，請商戶保持自身系統(tǒng)的時間準確。
1$ date +%s 21554208460第四步，生成一個請求隨機串，我們推薦生成隨機數(shù)算法如下：調(diào)用隨機數(shù)函數(shù)生成，將得到的值轉(zhuǎn)換為字符串。這里，我們使用命令行直接生成一個。
1$ hexdump -n 16 -e '4/4 "%08X" 1 "\n"' /dev/random 2593BEC0C930BF1AFEB40B4A08C8FB242第五步，獲取請求中的請求報文主體（request body）。
對于查詢單筆退款（通過商戶退款單號）接口的接口來說，請求報文主體是一個空串，只需要附加一個\n即可。
第六步，按照前述規(guī)則，構(gòu)造的請求簽名串如下：
1GET\n 2/v3/refund/domestic/refunds/123123123123\n 31554208460\n 4593BEC0C930BF1AFEB40B4A08C8FB242\n 5\n# 3. 計算簽名值
絕大多數(shù)編程語言提供的簽名函數(shù)支持對簽名數(shù)據(jù)進行簽名。強烈建議商戶調(diào)用該類函數(shù)，使用商戶私鑰對待簽名串進行SHA256 with RSA簽名，并對簽名結(jié)果進行Base64編碼得到簽名值。
1$ echo -n -e \2 'GET\n/v3/refund/domestic/refunds/123123123123\n1554208460\n593BEC0C930BF1AFEB40B4A08C8FB242\n\n' \3 | openssl dgst -sha256 -sign apiclient_test_key.pem \4 | openssl base64 -A得出的簽名值如下，你可以用一些校驗工具校驗?zāi)阃ㄟ^命令行或者你的代碼得到的簽名值是否和以下值一樣，一樣則表示計算過程無誤，如果不一致則請檢查簽名的參數(shù)是否一致、簽名串是否有嚴格換行、換行轉(zhuǎn)義是否有問題、是否多或者少了/（斜杠）等
1Lc9VXxmeonkdV8Xk9tmigQFLhl0vRWTerdmoRu01aAnYwIrD/5nsSwE1WlmZGLRlAFTNQ3QsMa0+VRDlJp1Wp5p0nO8EK68b5sJBbjouxaFciIfq1zfDWWz+jqhcMoKXI1A6dPm1AW7D4d30WsMTNzp6g23OXakIsh9LO3lUmwvTuE0BY8ncf6tNGk4wKmvXwERd/ZpoQY3MAVKz+Nakwc+2XBmzT66KcUehU5kr4IvGa/lEU5RZb/q00zP9VLdBhC/jQSX3X1UcJLCtEc4gTmib4tnmAT+bHF/e17ZAuxDNcx6rqT8gNEXqaJGG+1OflMSTU2tpyG65G4dMKdFcoA==# 4. 設(shè)置HTTP頭
微信支付商戶API v3要求請求通過HTTP Authorization頭來傳遞簽名。Authorization由認證類型和簽名信息兩個部分組成。
下面我們使用命令行演示如何生成簽名。
1Authorization: 認證類型 簽名信息具體組成為：
認證類型，目前為WECHATPAY2-SHA256-RSA2048
簽名信息
- 發(fā)起請求的商戶（包括直連商戶、服務(wù)商或渠道商）的商戶號mchid
- 商戶API證書序列號serial_no，用于聲明所使用的證書，注意這里是商戶API證書而不是平臺證書，請勿混用，如果不知道如何查看API證書序列號，可參考文檔文末的常見問題。
- 請求隨機串nonce_str，和你上面構(gòu)造簽名串的隨機串要保持一致
- 時間戳timestamp，和你上面構(gòu)造簽名串的時間戳要保持一致
- 簽名值signature，上面算出來的簽名值
提示
注意：以上五項簽名信息，無順序要求。
Authorization頭的示例如下：（注意，示例因為排版可能存在換行，實際數(shù)據(jù)應(yīng)在一行）
1Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900007291",nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",signature="Lc9VXxmeonkdV8Xk9tmigQFLhl0vRWTerdmoRu01aAnYwIrD/5nsSwE1WlmZGLRlAFTNQ3QsMa0+VRDlJp1Wp5p0nO8EK68b5sJBbjouxaFciIfq1zfDWWz+jqhcMoKXI1A6dPm1AW7D4d30WsMTNzp6g23OXakIsh9LO3lUmwvTuE0BY8ncf6tNGk4wKmvXwERd/ZpoQY3MAVKz+Nakwc+2XBmzT66KcUehU5kr4IvGa/lEU5RZb/q00zP9VLdBhC/jQSX3X1UcJLCtEc4gTmib4tnmAT+bHF/e17ZAuxDNcx6rqT8gNEXqaJGG+1OflMSTU2tpyG65G4dMKdFcoA==",timestamp="1554208460",serial_no="408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB"
最終我們可以組一個包含了簽名的HTTP請求了。
1$curl https://api.mch.weixin.qq.com/v3/refund/domestic/refunds/123123123123 \2-H 'Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900007291",nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",signature="Lc9VXxmeonkdV8Xk9tmigQFLhl0vRWTerdmoRu01aAnYwIrD/5nsSwE1WlmZGLRlAFTNQ3QsMa0+VRDlJp1Wp5p0nO8EK68b5sJBbjouxaFciIfq1zfDWWz+jqhcMoKXI1A6dPm1AW7D4d30WsMTNzp6g23OXakIsh9LO3lUmwvTuE0BY8ncf6tNGk4wKmvXwERd/ZpoQY3MAVKz+Nakwc+2XBmzT66KcUehU5kr4IvGa/lEU5RZb/q00zP9VLdBhC/jQSX3X1UcJLCtEc4gTmib4tnmAT+bHF/e17ZAuxDNcx6rqT8gNEXqaJGG+1OflMSTU2tpyG65G4dMKdFcoA==",timestamp="1554208460",serial_no="408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB"' \3-H 'Accept: application/json'
