EasyStore WP第一網・智慧網站服務
第一網編輯部

綠界金流串接申請流程與 API 串接常見技術錯誤排除指南

綠界金流串接申請流程與 API 串接常見技術錯誤排除指南

選擇綠界科技(ECPay)作為第三方支付的核心理由在於其高度整合的物流與電子發票系統,能讓中小企業在單一後台完成收款、對帳與出貨。目前個人賣家僅需身分證即可申請,但若需開啟信用卡分期功能,則必須具備公司行號資格。串接前應確認網站具備 SSL 憑證,並預留至少 3 到 5 個工作天的審核期。

依營業額與物流需求決定帳號類型與手續費率

申請綠界帳號前,必須先釐清「個人帳號」、「商務帳號」與「特約商店」的差異。個人帳號雖然申請速度最快,但信用卡交易手續費通常維持在 2.75% 且無法自訂分期期數;企業若每月交易額穩定超過新台幣 30 萬元,應直接申請商務帳號以爭取更低的手續費率。

帳號類型申請對象信用卡手續費(參考)收款上限核心功能限制
個人帳號個人、團媽、SOHO2.75%每月 30 萬不支援信用卡分期、不支援定期定額
商務帳號具備統一編號之企業2.15% - 2.5%視審核而定支援分期、定期定額、物流整合
特約商店年營業額千萬以上企業專案議價無上限可自訂付款頁面 UI、專屬客服

除了手續費,還需注意「提領手續費」。目前綠界撥款至非指定銀行(如國泰、台新等合作銀行之外)每筆會收取 10 至 15 元不等的匯費。若交易頻率高,建議開設綠界指定的合作銀行帳戶以節省長期成本。此外,超商代碼與條碼的手續費為固定金額(約 20-30 元),適合客單價較低的民生用品賣家。

系統串接優先選擇官方 SDK 以降低 Hash 驗證失敗率

在技術實作層面,最常導致串接失敗的原因是 CheckMacValue(檢查碼)運算錯誤。綠界要求所有傳輸參數必須依照字母順序排序,並結合 HashKey 與 HashIV 進行 AES 或 SHA256 加密。手動撰寫加密邏輯極易出錯,強烈建議使用綠界官方提供的 PHP、Python 或 .NET SDK。

  • HashKey 與 HashIV 管理:這兩組金鑰等同於提款卡密碼,絕對不可洩漏在前端網頁原始碼中。所有加密動作必須在伺服器端(Server-side)完成。
  • 測試環境與正式環境切換:測試時請使用測試特店編號(2000132),並確認測試信用卡號(如 4311-9522-2222-2222)。切換至正式環境時,務必更換 MerchantID、HashKey 與 HashIV,否則會出現 10100073 錯誤。
  • 參數長度限制:如 ItemName(商品名稱)若超過 200 字元會導致授權失敗,在串接購物車時應先進行字串截斷處理。

解決付款成功但訂單未轉正的 Server Post 回傳問題

這是最常見的客訴來源:消費者付完錢了,但網站訂單卻顯示「待付款」。這通常是因為伺服器的 OrderResultURL 或 ReturnURL 設定錯誤。綠界在使用者付款完成後,會透過伺服器對伺服器(Server-to-Server)的方式發送通知到你的網站。若你的伺服器設有防火牆(WAF)或使用了 Cloudflare 的高強度驗證,可能會阻擋綠界的通知 IP,導致網站沒收到付款成功訊號。

確保回傳成功的檢查清單

  • 防火牆白名單:將綠界的通知伺服器 IP 加入白名單,避免 403 Forbidden 錯誤。
  • 回應 1|OK:當你的伺服器接收到綠界的通知(ReturnURL)後,必須在頁面輸出 1|OK。如果綠界沒看到這兩個字,會視為通知失敗,並在接下來的 24 小時內持續重發通知,這可能導致重複扣款或訂單邏輯混亂。
  • 避免 Session 依賴:ReturnURL 是背景通知,不帶有使用者的瀏覽器 Session。判斷訂單是否付款成功,必須依賴資料庫中的 MerchantTradeNo(特店交易編號),而非 Session ID。

信用卡風險管理與 3D 驗證的開啟準則

為了降低盜刷風險,綠界預設會開啟 3D 驗證。雖然這會增加消費者的結帳步驟(需輸入簡訊驗證碼),可能導致轉單率下降約 5% - 10%,但這能免除商家在盜刷發生時的「爭議帳款」損失。若你的商品屬於高單價(超過 5,000 元)或數位資產(點數、序號),絕對不可關閉 3D 驗證。

若經營的是低單價、回購率高的民生用品,可考慮向綠界申請調降風險過濾器等級。但請注意,一旦發生盜刷且未經過 3D 驗證,銀行會直接扣除該筆款項並向商家收取處理費,這筆代價通常遠高於流失的訂單利潤。目前 2026 年的支付趨勢中,生物識別(如 Apple Pay / Google Pay)已逐漸取代傳統驗證,建議一併開啟這類行動支付功能,既能兼顧安全又能維持轉換率。

資金周轉規劃與撥款天數計算

綠界的撥款並非即時入帳。標準撥款週期為 T+7(工作天),這意味著週一產生的交易,最快要到下週三以後才能提領。對於資金壓力較大的電商,這 7 到 10 天的空窗期必須列入現金流計算。如果需要縮短撥款週期至 T+3,通常需要支付額外的年費或提高手續費百分比。

常見的撥款延遲原因

  1. 連假效應:由於撥款以「銀行營業日」計算,遇到春節或長假,撥款時間會順延,商家應提前備足營運資金。
  2. 物流未結案:若使用綠界整合物流(如 7-11 取貨付款),款項必須等到超商回傳「已取貨」訊號後才開始計算撥款天數。若消費者遲未取貨,該筆資金會被凍結在綠界系統中直到退貨流程完成。
  3. 異常交易監控:若短時間內出現大量同金額、同 IP 的交易,綠界風控部門可能會暫時凍結撥款並要求提供出貨憑證(如物流單據、發票)以供審核。

檢查網站目前的 ReturnURL 是否能正常接收外部請求,並在瀏覽器直接輸入該網址測試是否會噴出 404 或 500 錯誤。若網址無法從外網存取,金流串接絕對無法成功更新訂單狀態。

GET STARTED

開始你的 WordPress

加入我們並獲得最專業的技術與設計團隊支持

開始使用 — LINE 線上諮詢
綠界金流串接申請流程與 API 串接常見技術錯誤排除指南 | EasyStore WP