Design News

網頁設計新知

如何找到綠界科技商店代號與 HashKey、HashIV?金流串接必備參數一次搞懂

Aug 07, 2026
目錄

快速摘要 TL;DR：串接綠界金流 API 需要 3 組關鍵參數——商店代號、HashKey、HashIV，全部集中在廠商後台的「系統設定 > 系統介接設定」頁面。若還在開發測試，官方也提供Sandbox專用參數可直接套用，正式上線前再替換為正式後台的真實值即可。

第一次串接綠界金流，最常卡關的一步就是：這三組參數到底在哪裡找？後台選單那麼多，進去繞了一圈還是找不到。其實位置固定，只要知道路徑，30 秒就能拿到。

什麼是商店代號、HashKey、HashIV？

這三組值是串接綠界 API 時的身份識別與加密驗證憑證，缺一不可：

參數名稱用途說明
商店代號（MerchantID）識別您的商家身份，每次 API 請求都需帶入
HashKey用於產生加密檢查碼（CheckMacValue）的金鑰
HashIV搭配 HashKey 做 AES 加密的初始向量

⚠️ 安全提醒：HashKey 與 HashIV 屬於機敏資訊，請存放於伺服器端（環境變數或設定檔），切勿寫進前端程式碼或公開在版本庫中。

操作步驟：登入綠界廠商後台

步驟一：登入廠商後台

前往綠界廠商後台，輸入賣家帳號、登入密碼、證號末四碼及驗證碼後登入。

綠界廠商後台登入
▲ 畫面截圖於 2026 年 6 月，介面如有更新請以官網為準

步驟二：進入系統設定 > 系統介接設定

登入後，於左側選單依序點選：

系統設定 › 系統介接設定

步驟三：找到介接資訊

進入頁面後，在「介接資訊」區塊即可看到以下 3 組參數：

  • 商店代號（MerchantID）
  • 介接 HashKey
  • 介接 HashIV
商店代號、HashKey、HashIV 位置
▲ 畫面截圖於 2026 年 6 月，介面如有更新請以官網為準

測試環境（Sandbox）參數

如果您目前還在開發測試階段，可直接使用綠界官方提供的 Sandbox 參數，無需登入後台即可取得：

參數測試值
MerchantID2000132
HashKey5294y06JbISpM5x9
HashIVv77hoKGq4kWxNNIS

⚠️ 上線前記得替換：Sandbox 參數僅供測試使用，正式部署時務必替換為廠商後台的正式參數，否則交易將無法真實收款。

需要協助串接金流或建置電商網站？

鉅潞科技提供完整電商購物網站規劃與開發服務，從金流串接到後台管理系統一手包辦，歡迎免費諮詢。

☎️ 立即預約免費諮詢

常見問題（FAQ）

以下整理最常被問到的 5 個問題。

Q：商店代號和廠商編號是同一個東西嗎？▼ 展開/收合
A：是的，兩者指的是同一組數字，只是不同頁面或文件中的稱呼不同。在 API 文件中統一稱為 MerchantID，就是您後台介接資訊裡的「商店代號」。
Q：HashKey 和 HashIV 可以自己設定嗎？▼ 展開/收合
A：不行，這兩組值是綠界系統自動產生並指派給您的商店，無法自行修改。若懷疑金鑰外洩，請聯繫綠界客服申請重新產生。
Q：找不到「系統介接設定」選項怎麼辦？▼ 展開/收合
A：請確認您登入的帳號已完成廠商審核，並已開通金流服務。部分服務尚未申請開通時，相關選單可能不會顯示。可至「申請其他服務」確認開通狀態。
Q：測試環境和正式環境的 API 網址一樣嗎？▼ 展開/收合
A：不一樣。測試環境（Sandbox）的 API 端點與正式環境不同，請參考綠界官方技術文件（developers.ecpay.com.tw）確認各環境的正確網址，避免混用。
Q：HashKey / HashIV 可以放在前端程式碼裡嗎？▼ 展開/收合
A：絕對不行。這兩組金鑰一旦暴露，任何人都可以偽造您的交易請求。請務必存放在後端伺服器的環境變數或加密設定檔中，不得出現在任何前端或版本庫的公開程式碼裡。

結語

找到商店代號、HashKey、HashIV 的路徑其實很固定，記住一句話就夠：系統設定 > 系統介接設定 > 介接資訊。開發測試期間直接用官方Sandbox參數，正式上線前再換成後台的真實值，這樣就不容易出錯。

有電商建置需求？立即免費諮詢 →

延伸閱讀

鉅潞科技

鉅潞科技編輯團隊

鉅潞科技 台南/台北網頁、網站設計 x 數位行銷專家公司首選推薦

鉅潞科技成立近 20 年，累積超過 4,000 家客戶服務經驗，專注於企業官網、電商購物網站與品牌形象網站的規劃與開發。我們始終堅持著「團隊合作」、「品質至上」、「服務第一」、「創新研究」的經營理念。

了解更多 →
back
返回頂部