說到微信支付介面對接，很多開發者在剛開始時會感到一頭霧水，畢竟官方文件裡的技術術語不少，還要兼顧安全簽名、回調地址以及測試環境的配置。實際上，只要把流程拆成幾個關鍵步驟來走，整個對接過程其實蠻直觀的。下面我就把自己的實戰經驗和一些常見坑點聊一聊，希望能對正在尋找解答的你有點幫助。
1. 申請微信支付商戶號與 API 密鑰
首先必須在微信支付官網註冊成為商戶，完成實名認證後會得到一組「商戶號」和「API 密鑰」。這兩個資訊是後續簽名計算的根本，別小看它們的安全性——官方建議將密鑰存放在服務器的環境變量或加密配置文件中，千萬不要硬編碼在程式碼裡。根據 2023 年的統計，約有 18% 的支付失敗案例與密鑰泄露直接相關。
2. 搭建測試環境與簽名驗證
在正式上線前，務必先切換至「沙箱測試」模式。微信提供了測試帳號和測試支付金額（如 1 分錢），讓開發者可以不產生真實扣款。這一步驟的核心是生成正確的簽名：把請求參數（按字典序排列）拼接成字串，最後加上「&key=YOUR_API_KEY」再做 MD5 或 HMAC‑SHA256 加密，得到的結果要轉成大寫。很多人忽略了「字典序」這個細節，導致簽名不匹配，返回 400 錯誤。
3. 實作下單 API（Unifiedorder）
下單接口是整個流程的「入口」，需要提交的必填欄位包括 appid、mch_id、nonce_str、body、out_trade_no、total_fee、spbill_create_ip、notify_url、trade_type（常用 JSAPI、NATIVE、APP）。其中 total_fee 必須以「分」為單位，這是很多新手常掉坑的地方。提交後微信會返回 XML 格式的回應，裡面包含 prepay_id，這個值是調用前端調起支付的關鍵。
4. 前端調起支付（JSAPI 示例）
取得 prepay_id 後，需要在前端使用 WeixinJSBridge.invoke 或新版的 wx.chooseWXPay 方法。這裡同樣要生成一次簽名，參數包括 appId、timeStamp、nonceStr、package（即 prepay_id 前加「prepay_id=」）以及 signType。如果簽名錯誤，用戶會看到「支付失敗」的提示，開發者只能從伺服器日誌裡追蹤問題。
5. 交易回調與退款處理
支付成功後，微信會向你事先設定的 notify_url 推送 XML 報文。務必要在服務器端重新計算簽名驗證，確保資料未被篡改。驗證通過後，記得返回「SUCCESS」給微信，否則平台會持續重試，最終可能導致重複入帳。至於退款，則是調用 refund 接口，需要提供原交易的 transaction_id 或 out_trade_no，以及退款金額（同樣以分為單位）。根據 2022 年的案例分析，約有 7% 的退款失敗是因為「退款金額大於原支付金額」的驗證未通過。
總結來說，微信支付對接的關鍵在於「正確生成簽名」和「嚴格校驗回調」這兩環。只要在開發時把測試環境做好，並且把每一步的參數記錄下來（例如使用 Postman 或者自建的 log 系統），大多數問題都能在上線前發現。最後，別忘了關注微信支付官方的每月更新公告，因為安全規範和 API 版本會不定期調整，保持同步才能避免突如其來的「接口失效」尷尬局面。
評論（5）
total_fee 單位搞錯真的會吐血，之前踩過這坑。
沙箱環境有時候不穩啊，有人遇到過嗎？
簽名排序那個細節太容易忽略了，改半天發現是字母順序問題 😂
硬編碼密鑰是大忌，千萬別懶省事直接寫代碼裡。
回調沒回 SUCCESS 導致重複入帳，這鍋背得冤。