請(qǐng)求參數(shù)里帶Body參數(shù)(包體參數(shù)），如何計(jì)算簽名

更新時(shí)間：2024.08.22

為了方便大家理解，我們將使用測(cè)試的一對(duì)公私鑰，通過(guò)命令行形式調(diào)用"JSAPI下單接口 (opens new window)"，一步一步介紹如何請(qǐng)求參數(shù)里帶Body參數(shù)(包體參數(shù))，如何計(jì)算簽名。強(qiáng)烈建議你使用測(cè)試的公私鑰，按照本文實(shí)操作一下，如果算出來(lái)的簽名和文檔的一致則說(shuō)明計(jì)算無(wú)誤。實(shí)際業(yè)務(wù)中請(qǐng)?zhí)鎿Q為你的真實(shí)的參數(shù)。
alt text

# 1. 準(zhǔn)備

商戶(hù)需要擁有一個(gè)微信支付商戶(hù)號(hào)，并通過(guò)超級(jí)管理員賬號(hào)登錄商戶(hù)平臺(tái)，獲取商戶(hù)API證書(shū)，可以參考如何獲取商戶(hù)API證書(shū) (opens new window)。商戶(hù)申請(qǐng)商戶(hù) API 證書(shū)時(shí)，證書(shū)工具會(huì)生成商戶(hù)私鑰，并保存在本地證書(shū)文件夾的文件 apiclient_key.pem 中。私鑰也可通過(guò)工具從商戶(hù)的 p12 證書(shū)中導(dǎo)出。請(qǐng)妥善保管好商戶(hù)私鑰文件。請(qǐng)注意計(jì)算簽名需要用到的是商戶(hù)API證書(shū)而不是平臺(tái)證書(shū)，請(qǐng)不要搞混。

商戶(hù)號(hào)：1900007291

證書(shū)序列號(hào)：408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB

API證書(shū)私鑰：你需要將以下文件保存為pem格式，為了避免大家和自己的真實(shí)的公私鑰混淆，此處將其保存為了apiclient_test_key.pem，這只是一個(gè)示例密鑰，實(shí)際上并不可用

# 2. 構(gòu)造簽名串

我們希望商戶(hù)的技術(shù)開(kāi)發(fā)人員按照當(dāng)前文檔約定的規(guī)則構(gòu)造簽名串。微信支付會(huì)使用同樣的方式構(gòu)造簽名串。如果商戶(hù)構(gòu)造簽名串的方式錯(cuò)誤，將導(dǎo)致簽名驗(yàn)證不通過(guò)。下面先說(shuō)明簽名串的具體格式。

簽名串一共有5個(gè)部分，每一行為一個(gè)參數(shù)。結(jié)尾以\n（換行符，ASCII編碼值為0x0A）結(jié)束，包括最后一行。如果參數(shù)本身以\n結(jié)束，也需要附加一個(gè)\n。

1HTTP請(qǐng)求方法\n
2URL\n
3請(qǐng)求時(shí)間戳\n
4請(qǐng)求隨機(jī)串\n
5請(qǐng)求報(bào)文主體\n

以JSAPI下單接口為例，

第一步，獲取HTTP請(qǐng)求的方法

1POST

第二步，獲取請(qǐng)求的絕對(duì)URL，請(qǐng)注意需要去除域名部分。

1/v3/pay/transactions/jsapi

第三步，獲取發(fā)起請(qǐng)求時(shí)的系統(tǒng)當(dāng)前時(shí)間戳，即格林威治時(shí)間1970年01月01日00時(shí)00分00秒(北京時(shí)間1970年01月01日08時(shí)00分00秒)起至現(xiàn)在的總秒數(shù)，作為請(qǐng)求時(shí)間戳。微信支付會(huì)拒絕處理很久之前發(fā)起的請(qǐng)求，請(qǐng)商戶(hù)保持自身系統(tǒng)的時(shí)間準(zhǔn)確。

1$ date +%s 
21554208460

第四步，生成一個(gè)請(qǐng)求隨機(jī)串，我們推薦生成隨機(jī)數(shù)算法如下：調(diào)用隨機(jī)數(shù)函數(shù)生成，將得到的值轉(zhuǎn)換為字符串。這里，我們使用命令行直接生成一個(gè)。

1$ hexdump -n 16 -e '4/4 "%08X" 1 "\n"' /dev/random 
2593BEC0C930BF1AFEB40B4A08C8FB242

第五步，獲取請(qǐng)求中的請(qǐng)求報(bào)文主體（request body）。

你可以將所有參數(shù)放在一行，對(duì)應(yīng)的發(fā)起簽名請(qǐng)求的時(shí)候body參數(shù)也應(yīng)該放在一行。

你也可以將參數(shù)以多行計(jì)算簽名，對(duì)應(yīng)發(fā)起請(qǐng)求的時(shí)候body參數(shù)也要是多行。即你計(jì)算簽名時(shí)body是怎么樣的，你發(fā)起請(qǐng)求時(shí)body就應(yīng)該是怎么樣的。

這里以將所有參數(shù)放到一行做演示，如果你想了解將參數(shù)放在多行可以參考文末說(shuō)明

1{"appid":"wxd678efh567hg6787","mchid":"1230000109","description":"Image形象店-深圳騰大-QQ公仔","out_trade_no":"1217752501201407033233368018","notify_url":"https://www.weixin.qq.com/wxpay/pay.php","amount":{"total":100,"currency":"CNY"},"payer":{"openid":"oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"}}

第六步，按照前述規(guī)則，構(gòu)造的請(qǐng)求簽名串如下：

1POST\n 
2/v3/pay/transactions/jsapi\n 
31554208460\n 
4593BEC0C930BF1AFEB40B4A08C8FB242\n 
5{"appid":"wxd678efh567hg6787","mchid":"1230000109","description":"Image形象店-深圳騰大-QQ公仔","out_trade_no":"1217752501201407033233368018","notify_url":"https://www.weixin.qq.com/wxpay/pay.php","amount":{"total":100,"currency":"CNY"},"payer":{"openid":"oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"}}\n

# 3. 計(jì)算簽名值

絕大多數(shù)編程語(yǔ)言提供的簽名函數(shù)支持對(duì)簽名數(shù)據(jù)進(jìn)行簽名。強(qiáng)烈建議商戶(hù)調(diào)用該類(lèi)函數(shù)，使用商戶(hù)私鑰對(duì)待簽名串進(jìn)行SHA256 with RSA簽名，并對(duì)簽名結(jié)果進(jìn)行Base64編碼得到簽名值。

請(qǐng)注意處理單雙引號(hào)轉(zhuǎn)義問(wèn)題，第二行的外層是單引號(hào)，則里面的參數(shù)不需要轉(zhuǎn)義，如果第二行最外層使用了雙引號(hào)，則body參數(shù)的雙引號(hào)都需要轉(zhuǎn)義

1$ echo -n -e \
2 'POST\n/v3/pay/transactions/jsapi\n1554208460\n593BEC0C930BF1AFEB40B4A08C8FB242\n{"appid":"wxd678efh567hg6787","mchid":"1230000109","description":"Image形象店-深圳騰大-QQ公仔","out_trade_no":"1217752501201407033233368018","notify_url":"https://www.weixin.qq.com/wxpay/pay.php","amount":{"total":100,"currency":"CNY"},"payer":{"openid":"oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"}}\n' \
3 | openssl dgst -sha256 -sign apiclient_test_key.pem \
4 | openssl base64 -A

得出的簽名值如下，你可以用一些校驗(yàn)工具校驗(yàn)?zāi)阃ㄟ^(guò)命令行或者你的代碼得到的簽名值是否和以下值一樣，一樣則表示計(jì)算過(guò)程無(wú)誤，如果不一致則請(qǐng)檢查簽名的參數(shù)是否一致、簽名串是否有嚴(yán)格換行等

1gEuexJ547PHFV77TQ6eiE4tphVYfWfUe1Wc2dBmVnoMYU2rl/M4zhw+b3vBhuMw6AC7pteNkryLA7UWU2h+umo0OdSuuLm1++O3NckQPCSfm6dypsjn4GYm84KMqXWFrhFmyxEwIdEJDr3w1UYfxOcu55OQupfLkrt/ZzuOspnliJFrPzGQFUk7lGqMMtpz3EfbDUNxnVsHblORg3hVmuYNmbGWnS2ovU30Y2Q+iKFDxzkaXBk8LTy6HzvxizRo6Q+J4SVM7O0hKXfgo1QdI68kpzNULb3EVBXlhTyPUzhkHzzLxECL1qHl3HH2hEv8++C+4wBlsagF3j/O6PABojA==

# 4. 設(shè)置HTTP頭

微信支付商戶(hù)API v3要求請(qǐng)求通過(guò)HTTP Authorization頭來(lái)傳遞簽名。Authorization由認(rèn)證類(lèi)型和簽名信息兩個(gè)部分組成。

下面我們使用命令行演示如何生成簽名。

1Authorization: 認(rèn)證類(lèi)型 簽名信息

具體組成為：

認(rèn)證類(lèi)型，目前為WECHATPAY2-SHA256-RSA2048
簽名信息
- 發(fā)起請(qǐng)求的商戶(hù)（包括直連商戶(hù)、服務(wù)商或渠道商）的商戶(hù)號(hào)mchid
- 商戶(hù)API證書(shū)序列號(hào)serial_no，用于聲明所使用的證書(shū)，注意這里是商戶(hù)API證書(shū)而不是平臺(tái)證書(shū)，請(qǐng)勿混用，如果不知道如何查看API證書(shū)序列號(hào)，可參考文檔文末的常見(jiàn)問(wèn)題。
- 請(qǐng)求隨機(jī)串nonce_str，和你上面構(gòu)造簽名串的隨機(jī)串要保持一致
- 時(shí)間戳timestamp，和你上面構(gòu)造簽名串的時(shí)間戳要保持一致
- 簽名值signature，上面算出來(lái)的簽名值

提示

注意：以上五項(xiàng)簽名信息，無(wú)順序要求。

Authorization頭的示例如下：（注意，示例因?yàn)榕虐婵赡艽嬖趽Q行，實(shí)際數(shù)據(jù)應(yīng)在一行）

1Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900007291",nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",signature="gEuexJ547PHFV77TQ6eiE4tphVYfWfUe1Wc2dBmVnoMYU2rl/M4zhw+b3vBhuMw6AC7pteNkryLA7UWU2h+umo0OdSuuLm1++O3NckQPCSfm6dypsjn4GYm84KMqXWFrhFmyxEwIdEJDr3w1UYfxOcu55OQupfLkrt/ZzuOspnliJFrPzGQFUk7lGqMMtpz3EfbDUNxnVsHblORg3hVmuYNmbGWnS2ovU30Y2Q+iKFDxzkaXBk8LTy6HzvxizRo6Q+J4SVM7O0hKXfgo1QdI68kpzNULb3EVBXlhTyPUzhkHzzLxECL1qHl3HH2hEv8++C+4wBlsagF3j/O6PABojA==",timestamp="1554208460",serial_no="408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB"

最終我們可以組一個(gè)包含了簽名的HTTP請(qǐng)求了。

（1）請(qǐng)注意第六行的body參數(shù)必須在一行，不能換行，因?yàn)楹灻?jì)算簽名時(shí)body就是以一行來(lái)計(jì)算簽名的，這里發(fā)起請(qǐng)求時(shí)需要和簽名時(shí)的保持一致

（2）請(qǐng)注意Authorization的timestamp="1554208460",serial_no="408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB"必須和你計(jì)算簽名是傳入的值是一致的

（3）此處只是一個(gè)示例，用于大家參考計(jì)算的格式，由于示例密鑰本身是不可用的，因此以下請(qǐng)求并不真正可用

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi \
3  -H 'Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900007291",nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",signature="gEuexJ547PHFV77TQ6eiE4tphVYfWfUe1Wc2dBmVnoMYU2rl/M4zhw+b3vBhuMw6AC7pteNkryLA7UWU2h+umo0OdSuuLm1++O3NckQPCSfm6dypsjn4GYm84KMqXWFrhFmyxEwIdEJDr3w1UYfxOcu55OQupfLkrt/ZzuOspnliJFrPzGQFUk7lGqMMtpz3EfbDUNxnVsHblORg3hVmuYNmbGWnS2ovU30Y2Q+iKFDxzkaXBk8LTy6HzvxizRo6Q+J4SVM7O0hKXfgo1QdI68kpzNULb3EVBXlhTyPUzhkHzzLxECL1qHl3HH2hEv8++C+4wBlsagF3j/O6PABojA==",timestamp="1554208460",serial_no="408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB"' \
4  -H 'Accept: application/json' \
5  -H 'Content-Type: application/json' \
6  -d '{"appid":"wxd678efh567hg6787","mchid":"1230000109","description":"Image形象店-深圳騰大-QQ公仔","out_trade_no":"1217752501201407033233368018","notify_url":"https://www.weixin.qq.com/wxpay/pay.php","amount":{"total":100,"currency":"CNY"},"payer":{"openid":"oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"}}'

# 5、常見(jiàn)問(wèn)題請(qǐng)參考

# （1）簽名驗(yàn)簽常見(jiàn)問(wèn)題詳見(jiàn)簽名驗(yàn)證常見(jiàn)問(wèn)題

# （2）以下演示body有多個(gè)參數(shù)時(shí)，如何以多行來(lái)計(jì)算簽名并且發(fā)起請(qǐng)求

# 1.構(gòu)造簽名串

依然以JSAPI下單接口為例，前四步保持不變，

第五步，獲取請(qǐng)求中的請(qǐng)求報(bào)文主體（request body）。

將參數(shù)以多行計(jì)算簽名，對(duì)應(yīng)發(fā)起請(qǐng)求的時(shí)候body參數(shù)也要是多行。即你計(jì)算簽名時(shí)body是怎么樣的，你發(fā)起請(qǐng)求時(shí)body就應(yīng)該是怎么樣的。

1{
2"appid":"wxd678efh567hg6787",
3"mchid":"1230000109",
4"description":"Image形象店-深圳騰大-QQ公仔",
5"out_trade_no":"1217752501201407033233368018",
6"notify_url":"https://www.weixin.qq.com/wxpay/pay.php",
7"amount":{"total":100,"currency":"CNY"},
8"payer":{"openid":"oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"}
9}

第六步，按照前述規(guī)則，構(gòu)造的請(qǐng)求簽名串如下，每一行的結(jié)尾以\n（換行符，ASCII編碼值為0x0A）結(jié)束，包括最后一行。如果參數(shù)本身以\n結(jié)束，也需要附加一個(gè)\n

1POST\n 
2/v3/pay/transactions/jsapi\n 
31554208460\n 
4593BEC0C930BF1AFEB40B4A08C8FB242\n 
5{\n 
6"appid":"wxd678efh567hg6787",\n 
7"mchid":"1230000109",\n 
8"description":"Image形象店-深圳騰大-QQ公仔",\n 
9"out_trade_no":"1217752501201407033233368018",\n 
10"notify_url":"https://www.weixin.qq.com/wxpay/pay.php",\n 
11"amount":{"total":100,"currency":"CNY"},\n 
12"payer":{"openid":"oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"}\n 
13}\n

# 2.計(jì)算簽名值

1$ echo -n -e \
2'POST\n/v3/pay/transactions/jsapi\n1554208460\n593BEC0C930BF1AFEB40B4A08C8FB242\n{\n"appid":"wxd678efh567hg6787",\n"mchid":"1230000109",\n"description":"Image形象店-深圳騰大-QQ公仔",\n"out_trade_no":"1217752501201407033233368018",\n"notify_url":"https://www.weixin.qq.com/wxpay/pay.php",\n"amount":{"total":100,"currency":"CNY"},\n"payer":{"openid":"oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"}\n}\n' \
3 | openssl dgst -sha256 -sign apiclient_test_key.pem \
4 | openssl base64 -A

1E7pP5rphKguQ29ql13Vxt2+lumoZxvV44SU5vTij9YeK6qdf9/iIKVGCH+XjZZl/ov2HS0BGHmXFzrP7IwLMknPWlmB8MHnTHz4vUpONUGcOboN++SDTaFLp+wbFOzp+qH3bFGpjJc5MRpUCpuGobVfP2/hXICyYOfkd/xtdCdFUwdkJI8cuGgLJvOw36X3y+6WIz1sTfrTrioNswbTot12h3zEI7waLVlneJ0V93zHAIyCD3RX36iee6wnA2bI1xYgGDM7AgEWuqAHx5lljo0uD7UyxnkJIoqfFrwLeR5Fg0PnAM9Ue0vlAfMgIkMmJjNdMo6PmiXcjRmuEky6f7g==

# 3.設(shè)置HTTP頭

1Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900007291",nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",signature="E7pP5rphKguQ29ql13Vxt2+lumoZxvV44SU5vTij9YeK6qdf9/iIKVGCH+XjZZl/ov2HS0BGHmXFzrP7IwLMknPWlmB8MHnTHz4vUpONUGcOboN++SDTaFLp+wbFOzp+qH3bFGpjJc5MRpUCpuGobVfP2/hXICyYOfkd/xtdCdFUwdkJI8cuGgLJvOw36X3y+6WIz1sTfrTrioNswbTot12h3zEI7waLVlneJ0V93zHAIyCD3RX36iee6wnA2bI1xYgGDM7AgEWuqAHx5lljo0uD7UyxnkJIoqfFrwLeR5Fg0PnAM9Ue0vlAfMgIkMmJjNdMo6PmiXcjRmuEky6f7g==",timestamp="1554208460",serial_no="408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB"

# 4.發(fā)起請(qǐng)求

再次說(shuō)明你計(jì)算簽名時(shí)body是怎么樣的，你發(fā)起請(qǐng)求時(shí)body就應(yīng)該是怎么樣的，因?yàn)檫@里計(jì)算簽名時(shí)body是多行的，發(fā)起請(qǐng)求時(shí)body也應(yīng)該是嚴(yán)格一致的

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/pay/transactions/jsapi \
3  -H 'Authorization: WECHATPAY2-SHA256-RSA2048 mchid="1900007291",nonce_str="593BEC0C930BF1AFEB40B4A08C8FB242",signature="gEuexJ547PHFV77TQ6eiE4tphVYfWfUe1Wc2dBmVnoMYU2rl/M4zhw+b3vBhuMw6AC7pteNkryLA7UWU2h+umo0OdSuuLm1++O3NckQPCSfm6dypsjn4GYm84KMqXWFrhFmyxEwIdEJDr3w1UYfxOcu55OQupfLkrt/ZzuOspnliJFrPzGQFUk7lGqMMtpz3EfbDUNxnVsHblORg3hVmuYNmbGWnS2ovU30Y2Q+iKFDxzkaXBk8LTy6HzvxizRo6Q+J4SVM7O0hKXfgo1QdI68kpzNULb3EVBXlhTyPUzhkHzzLxECL1qHl3HH2hEv8++C+4wBlsagF3j/O6PABojA==",timestamp="1554208460",serial_no="408B07E79B8269FEC3D5D3E6AB8ED163A6A380DB"' \
4  -H 'Accept: application/json' \
5  -H 'Content-Type: application/json' \
6  -d '{
7"appid":"wxd678efh567hg6787",
8"mchid":"1230000109",
9"description":"Image形象店-深圳騰大-QQ公仔",
10"out_trade_no":"1217752501201407033233368018",
11"notify_url":"https://www.weixin.qq.com/wxpay/pay.php",
12"amount":{"total":100,"currency":"CNY"},
13"payer":{"openid":"oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"}
14}'

文檔是否有幫助

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v