第一網第一網
第一網編輯部

綠界金流串接帳號申請流程與技術整合成本評估指南

綠界金流串接帳號申請流程與技術整合成本評估指南

依據收款規模與公司身分選擇適當的綠界帳號類型

選擇綠界金流(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$ 57 天
超商代碼 / 條碼NT$ 20 - 30 / 筆NT$ 207 天

需要特別注意的是「撥款天數」。綠界並非即時撥款,通常會有 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 元試刷)來確保整個撥款流程與帳務對接無誤。

綠界金流串接帳號申請流程與技術整合成本評估指南 | 第一網