依據收款規模與公司身分選擇適當的綠界帳號類型
選擇綠界金流(ECPay)的第一步不是串接程式,而是決定帳號身分。這直接影響到你的手續費率、可收款上限以及是否能提供信用卡分期服務。目前綠界提供「個人會員」、「商務會員」與「特約商店」三種級別。若你是剛起步的微型電商,月營業額在 5 萬台幣以下,申請個人會員即可;但若你已有公司統編且預期年營業額超過 20 萬,直接申請商務會員或特約商店是更具成本效益的選擇。
個人會員的優勢在於申請快速,僅需身分證與銀行存摺影本,通常在 1-3 個工作天內即可開通。然而,個人會員無法提供信用卡分期功能,且單筆收款金額與每月收款總額有較嚴格的限制。商務會員則需要提供公司變更登記表、負責人身分證以及公司銀行帳戶,審核時間約需 5-7 個工作天,但能解鎖分期付款、定期定額收款等進階功能。對於長期經營的中小企業,商務會員的結算撥款週期通常也比個人會員更具彈性。
| 帳號類型 | 申請門檻 | 信用卡分期 | 收款額度限制 | 適用對象 |
|---|---|---|---|---|
| 個人會員 | 身分證、個人帳戶 | 無 | 較低(依綠界審核) | 個人賣家、斜槓創業者 |
| 商務會員 | 公司統編、公司帳戶 | 有(需另申請) | 中等 | 一般中小企業、網購品牌 |
| 特約商店 | 具規模之公司、高營業額 | 有(含多期數) | 高(客製化) | 連鎖企業、高單價商品電商 |
技術串接核心:API 認證機制與金鑰安全管理
在技術實作層面,綠界金流的串接核心在於 CheckMacValue(檢查碼)的運算。無論你是使用 PHP、Python 還是 Node.js,所有的訂單資料在傳送至綠界伺服器前,都必須透過 HashKey 與 HashIV 進行 AES 加密與 SHA256 雜湊運算。這是為了確保訂單金額、商品名稱與訂單編號在傳輸過程中沒有被惡意篡改。如果你使用的是 WooCommerce、OpenCart 或 Shopline 等成熟平台,通常只需在後台輸入這兩組金鑰即可;但若是自架站,開發者必須嚴格遵守綠界的加密演算法規範。
目前綠界已全面升級至全功能整合介面(AioCheckOut),建議開發者優先採用 V5 版本的 API。在串接過程中,有兩個最重要的 URL 必須設定正確:ReturnURL 與 OrderResultURL。ReturnURL 是 Server-to-Server 的通知,這是綠界伺服器在交易完成後,直接發送 POST 請求給你的主機,用於更新資料庫中的訂單狀態。OrderResultURL 則是消費者付款完成後,瀏覽器被重新導回你網站的頁面。絕大多數的「漏單」問題,都是因為 ReturnURL 被防火牆阻擋或程式邏輯錯誤導致伺服器未回傳「1|OK」給綠界,造成系統重複發送通知或判定交易失敗。
各收款管道手續費與撥款天數對照表
經營成本的精算必須包含金流手續費。綠界採取「不收年費、不收系統使用費,僅收交易手續費」的模式(電子發票除外)。這意味著有交易才產生費用,對於毛利較低的產業,信用卡手續費的 0.05% 差距就可能影響獲利。以下為目前主流收款管道的標準費率參考,實際費率可能依據你的簽約條件或產業風險類別有所調整。
| 收款管道 | 手續費率(商務會員參考) | 最低收費 | 撥款天數(交易日後) |
|---|---|---|---|
| 信用卡(國內卡) | 2.75% | 無 | 7 - 14 天 |
| 信用卡(國外卡) | 3.5% | 無 | 7 - 14 天 |
| 網路 ATM / 自動櫃員機 | 1% | NT$ 5 | 7 天 |
| 超商代碼 / 條碼 | NT$ 20 - 30 / 筆 | NT$ 20 | 7 天 |
需要特別注意的是「撥款天數」。綠界並非即時撥款,通常會有 7 至 14 天的留存期。如果你的生意屬於高週轉率性質(例如代購或生鮮),必須預留足夠的營運現金流。此外,若發生退款需求,信用卡手續費通常不會退還給商家,且部分退款流程需在綠界後台手動執行,這也是人力成本的一部分。
確保交易資料一致性的 Webhook 伺服器設定要點
為了避免「客戶已付錢,後台沒訂單」的客訴慘劇,你的伺服器必須能穩定接收綠界的 Webhook 通知(即 ReturnURL)。在 2026 年的技術環境下,建議採用以下三種檢查機制:第一,驗證來源 IP。雖然綠界的 IP 可能變動,但透過 CheckMacValue 的反向驗證是最保險的做法。當你的伺服器收到通知時,應將收到的參數重新依照 HashKey/HashIV 進行一次加密運算,比對算出來的 CheckMacValue 是否與綠界傳過來的一致。
第二,處理異步通知。有時 ReturnURL 會因為網路波動比 OrderResultURL 晚到,你的程式邏輯必須允許「先跳轉頁面,後更新狀態」。第三,冪等性(Idempotency)設計。綠界在未收到「1|OK」回覆時,會在 24 小時內多次嘗試發送通知。你的後台程式必須確保同一筆訂單在收到多次成功通知時,不會重複觸發發信、扣庫存或給點數的邏輯。建議在資料庫中設定訂單狀態鎖定機制,一旦狀態變更為「已付款」,後續重複的通知應直接忽略並回傳成功訊號。
電子發票與物流服務的進階串接成本考量
當金流串接完成後,下一步通常是物流與電子發票的自動化。綠界提供的一站式服務包含 B2C(大宗寄倉)與 C2C(店到店)物流串接。如果你的出貨量每天超過 50 件,串接 B2C 物流 API 可以自動產生托運單,節省大量人工輸入時間。然而,物流串接涉及標籤列印格式(如熱感應紙規範)與退貨逆物流處理,技術複雜度高於金流串接。
至於電子發票,這是綠界少數需要收取「設定費」或「年費」的服務。目前的法規要求營業額達到一定規模後必須開立電子發票。串接綠界電子發票 API 的好處在於,當 ReturnURL 確認付款成功時,系統可以自動觸發開立發票並透過 Email 寄送給消費者。這能省下購買實體發票機與人工寄送掛號的費用。在評估成本時,請務必將「發票張數授權費」計算進去,通常以每組 500 或 1000 張為單位計費。若你的商品單價低、交易筆數多,發票成本將會是不可忽視的支出。
若要開始串接,請先前往綠界官網申請「測試帳號」(Stage 環境),取得測試用的 MerchantID、HashKey 與 HashIV。在測試環境下,你可以使用模擬信用卡號進行交易,確認 ReturnURL 能正確更新你的訂單系統後,再切換至正式環境的金鑰。切記,正式環境開通後,務必進行一筆小額的真實交易(例如 1 元試刷)來確保整個撥款流程與帳務對接無誤。
