讓 WooCommerce 結帳頁出現綠界 ECPay 的付款方式。設定都在 WooCommerce「設定 → 付款」的「AlphaBolt 付款」頁完成:建立綠界商店設定並填入串接資料,加入要提供的付款方式並選用那筆商店設定,測試付款成功後再啟用。綠界可加入的付款方式有信用卡一次付清、ATM 虛擬帳號、超商代碼、超商條碼與網路 ATM,並可搭配 WooCommerce Subscriptions 販售訂閱商品。
開始前準備
- 已安裝並啟用 WooCommerce。
- 已訂閱收款金流,AlphaBolt for WooCommerce 主外掛顯示「已連線」,金流模組顯示「已啟用」。
- 已有綠界 ECPay 的商店帳號,並已向綠界開通要提供的付款方式。
還沒安裝外掛或還沒連線?
- 到 AlphaBolt 會員中心的「外掛」頁 下載主外掛。下載清單目前顯示的名稱是 AlphaBolt Connect。
- 在 WordPress 後台「外掛 → 安裝外掛 → 上傳外掛」上傳 ZIP,按「立即安裝」後「啟用外掛」。
- 開啟左側「AlphaBolt」,在設定精靈按「連線驗證」,確認顯示「已連線」且「已授權類別」有金流,再依畫面完成精靈。
- 在 AlphaBolt 首頁的「AlphaBolt 模組」區塊,金流模組按「安裝」,確認狀態變成「已啟用」。
只啟用金流模組而沒有啟用主外掛時,會出現「AlphaBolt 金流需要「AlphaBolt Connect」外掛才能運作」的提示,先回到第 1 步。
其他安裝狀況見 安裝模組與開始設定 的「安裝問題說明與排除」。
綠界的串接資料在哪裡取得?
- 正式資料:登入綠界廠商管理後台,在「系統設定 → 系統介接設定 → 介接資訊」取得 Merchant ID、Hash Key、Hash IV。
- 測試資料:綠界公開的測試特店,只能用在綠界測試環境(來源:測試介接資訊)。
- Merchant ID:
3002607 - Hash Key:
pwFHCqoQZGmho4w6 - Hash IV:
EkRm7iFT261dpevs - 測試信用卡:
4311-9511-1111-1111,安全碼任意三碼,有效月年填晚於本月的日期 - 3D 驗證簡訊碼:固定
1234
- Merchant ID:
設定順序
- 前往 商店設定,建立綠界商店設定並填入串接資料。
- 依要提供的付款方式,各自完成加入、設定、測試與啟用:
- 要依訂單金額、會員角色或購物車商品調整付款選項時,前往 付款條件規則;要用第二個帳號分開收款,前往 多商店帳號。
共通排錯
結帳頁看不到綠界的付款方式
- 確認該列已切換為「啟用」。
- 確認該列引用的商店設定「正式」資料完整。儲存時正式資料不完整的付款方式會被自動停用,畫面顯示「付款方式「名稱」的商店設定不完整,已自動停用。請填完整組商店設定欄位。」補齊該筆商店設定的「正式」欄位後儲存,再把該列切回「啟用」。
- 確認「AlphaBolt 付款」頁沒有顯示「此設定目前為唯讀」。顯示時按「前往連線驗證」完成連線;訂閱失效或類別未授權時,到會員中心續訂或加訂。先前儲存的設定會保留。
付款完成後,訂單仍停在待付款
- 確認網站使用訂閱的網址,可從外部連線,並關閉維護模式與密碼保護。
- 網站前面有防火牆或 CDN 時,放行外部對
/wp-json的請求。 - 到綠界後台查詢這筆訂單的付款狀態。
綠界付款頁顯示錯誤代碼 10200141
- 測試環境:確認商店設定的「測試」三欄與「綠界的串接資料在哪裡取得?」中的測試資料相同。
- 正式環境:綠界收款服務尚未開通,或帳號超過一年沒有交易而暫停收款,請聯繫綠界。