綠界金流串接要準備的東西分成三類:以貴公司名義申請的特約商店資格、一個能建立訂單並接收付款通知的網站,以及一支從外部連得到的付款通知網址。真正花時間的不是寫「導到付款頁」那一段,而是審核文件、測試環境裡的 8 個情境,以及切換正式參數那一天的驗收。這篇依照實際做的順序拆成 5 個階段,每個階段寫清楚誰負責、要準備什麼、怎麼判斷這一步完成了。
付款方式有哪些、我們串接的原則與費用分工,已經整理在金流串接・網站刷卡服務頁,這裡不重列;本文的技術細節以綠界開發者文件(全方位金流 AIO)與綠界客服中心 2026 年 11 月的內容為準,綠界日後若調整規定,以官方最新公告為準。還在猶豫要不要自己架購物車的,可以先看自架購物車還是上電商平台。
綠界金流串接的 5 個階段:誰負責、怎麼算完成
多數企業以為金流串接是「工程師接一下 API」,實際上有一半的工作在企業自己身上——申請帳號、準備文件、決定付款方式與退款規則,都不是廠商能代為決定的。先看整體分工:
| 階段 | 主要負責 | 要做的事 | 完成的判斷 |
|---|---|---|---|
| 1. 申請與審核 | 企業 | 以公司名義註冊綠界會員、上傳文件、申請要開通的付款方式 | 綠界後台看得到正式的特店編號與金鑰 |
| 2. 規劃訂單流程 | 企業+廠商 | 決定付款方式、訂單狀態有哪幾種、取號未繳多久失效、退款怎麼處理 | 有一張雙方確認過的訂單狀態表 |
| 3. 測試環境串接 | 廠商 | 用綠界公開的測試特店資料寫好建立訂單、付款通知、查詢訂單三段程式 | 本文第三節 8 個情境全部走過,結果有紀錄 |
| 4. 切換正式參數 | 廠商+企業 | 換上正式特店編號、HashKey、HashIV 與正式網址 | 金鑰只存在主機設定檔,前端原始碼查不到 |
| 5. 上線驗收 | 企業+廠商 | 用真實的卡實際付一筆、確認入帳與訂單狀態、核對撥款 | 第一筆正式交易從付款到撥款都對得起來 |
階段 1 與階段 3 可以同時進行。綠界提供公開的測試環境,測試網址的網域是 payment-stage.ecpay.com.tw,正式則是 payment.ecpay.com.tw;審核還沒通過時,工程端就能用測試特店資料把流程做完。審核一通過,只要換參數與網址,不必等審核完才開始寫程式。
申請特約商店前,先確認這 6 件事
依綠界客服中心的說明,商務身分只接受在台灣註冊成立的公司行號、財社團法人及人民團體,以統一編號驗證;要準備的文件包括公司負責人身分證件正反面、公司名下台幣帳戶的存摺封面、公司設立登記或相關執照證明,以及公司環境照片 4 張,驗證需 2~5 個工作日(不含例假日)。個人身分則以身分證驗證,同一證號只能申請一個帳號。文件本身不難,真正會讓專案延誤的,是下面這 6 件事沒有在申請前想清楚:
- 帳號用誰的名義申請。一律以貴公司名義申請、款項撥入公司帳戶,開發廠商只用測試環境或被授權的權限協助。用廠商或員工個人名義申請,日後換廠商、員工離職時,收款帳號會跟著走。
- 要開通哪些付款方式。信用卡一次付清、ATM 虛擬帳號、超商代碼是中小企業最常用的組合;分期與綁定信用卡,綠界官網註明要另外聯繫銷售顧問。實際能用哪些,以審核結果與合約為準。
- 海外客人刷不刷得到。綠界文件寫明,是否支援海外卡「依照特店是否設定開通海外卡功能而定」。客人有一定比例在海外的,申請時就要問清楚,不要上線後才發現;要不要搭配其他金流或改走 PayPal,判斷方法見綠界、藍新、PayPal 怎麼選。
- 撥款節奏能不能接受。綠界官網寫一般賣家的金流代收款項「於付款後 10 日內撥款」,特約賣家則依議定。現金流吃緊的公司,要把這段時間差算進去。
- 網站上的商品與交易條件是否完整。申請時要提供販售網址,網站上看得到商品或服務內容、價格、退換貨與聯絡方式,審核比較順利;網站還在改版的,至少先把這幾頁做好。
- 誰保管後台帳號與金鑰。綠界後台的登入帳號、HashKey 與 HashIV 等同收款鑰匙,指定公司內一位窗口保管,交給廠商時只給串接需要的部分,並記錄給了誰。
測試環境要測哪 8 個情境
綠界「測試介接資訊」頁面公開了測試用的特店編號(目前為 3002607)、HashKey 與 HashIV,以及測試信用卡號 4311-9522-2222-2222,安全碼任意輸入三碼數字,有效月年要填大於當下的時間。網路上流傳的範例程式常寫 2000132,那是文件範例欄位的示意值,不是測試特店資料,照抄可能測不起來。
測試的重點不是「刷一筆成功」,而是把會讓訂單狀態對不起來的情況全部走一次。下面是我們上線前必走的 8 個情境:
| 情境 | 怎麼測 | 網站應該怎麼反應 |
|---|---|---|
| 1. 信用卡付款成功 | 用測試卡號完成付款 | 收到付款通知後才把訂單改為已付款,並回應 1|OK |
| 2. 信用卡付款失敗 | 在付款頁取消或輸入錯誤資料 | 訂單維持未付款,客人可以重新付款,不會產生第二張訂單 |
| 3. 客人付完款直接關視窗 | 付款完成後不按返回、直接關掉分頁 | 訂單照樣更新,因為依據的是伺服器端通知,不是前端導回 |
| 4. 同一筆通知送了兩次 | 讓通知程式故意不回應 1|OK,等綠界重送 | 第二次通知只記錄、不重複入帳、不重複寄信或開通 |
| 5. 偽造的付款通知 | 自己送一筆檢查碼錯誤的通知 | 檢查碼驗證不過就不處理,並留下紀錄 |
| 6. 金額不符 | 通知內容的金額與訂單金額不同 | 不改狀態,列為異常交易由人工確認 |
| 7. ATM/超商取號未繳 | 取得虛擬帳號或代碼但不付款 | 訂單顯示「待繳費」與繳費期限,客人看得到帳號或代碼 |
| 8. 繳費期限過了 | 把測試訂單的期限設短,等它過期 | 訂單改為失效,客人重新下單時拿到新的帳號或代碼 |
情境 1、3、4 對應的是綠界文件裡最重要的一段規定:付款結果以 ReturnURL 收到的伺服器端通知為準,前端的 OrderResultURL 只是讓客人看到結果的頁面,ClientBackURL 更只是「返回商店」的按鈕、不帶付款結果。網站收到通知後要回應 1|OK;沒有正確回應,綠界會隔 5~15 分鐘重發,當天重複發送四次。文件也特別提醒,回應 1|OK 只是告訴綠界「我收到了」,不會改變付款狀態,所以情境 4 的重複通知一定會發生,程式必須能辨識。
情境 5 靠的是檢查碼 CheckMacValue。做法是把參數依名稱排序後串起來,前後加上 HashKey 與 HashIV,經過網址編碼、轉小寫,再以 SHA256 產生雜湊值並轉大寫,網站收到通知時用同樣的方式算一次,兩邊一致才處理。文件另外建議,收到付款結果時再呼叫查詢訂單 API(QueryTradeInfo)核對一次,這也是情境 6 金額不符時的人工確認依據。
情境 7、8 是最常被漏掉的。ATM 虛擬帳號的繳費期限可以設 1 到 60 天,未設定時預設 3 天;超商代碼未設定時預設 10,080 分鐘(7 天),上限 43,200 分鐘。訂單狀態表裡如果只有「未付款」「已付款」兩種,取號後還沒繳的客人就會被當成棄單,期限過了也沒有人通知他重新下單。
付款通知網址的 3 個限制,上線前要先確認
一、綠界只支援 80 與 443 埠,ReturnURL 不要指定其他埠號,否則收不到通知。二、這支網址必須從公司網域之外連得到,不能放在後台登入保護、IP 限制或維護模式之後;網站前面有 CDN 的,依文件說明要設定主機的網址而不是 CDN 網址。三、ReturnURL 不支援中文網址。另外,特店訂單編號(MerchantTradeNo)最長 20 字元、只能用英數字,且不可重複使用,訂單編號規則要在階段 2 就訂好。
切換正式參數與上線當天:我們自己的做法
8 個情境都測過,才進入階段 4。切換本身只是換掉特店編號、HashKey、HashIV 與兩個網址,但有三條規矩我們每次都照做:金鑰只放在主機上的設定檔,不寫進網頁原始碼、不放進前端的 JavaScript;測試與正式的參數分開存放,用一個設定值切換,避免改一半變成「正式網址配測試金鑰」;切換前備份網站程式與資料庫,出問題可以退回測試狀態。
上線當天的驗收,企業窗口要親自參與:
上線當天的 6 個步驟
一、用公司或負責人的真實信用卡,對一筆小金額的訂單實際付款。二、確認網站訂單改為已付款,並在主機紀錄裡看到綠界送來的通知與 1|OK 回應。三、登入綠界後台,確認同一筆交易的訂單編號與金額一致。四、對這筆交易執行一次退款或取消,確認後台與網站的處理流程都說得通。五、用 ATM 取號一次、實際轉帳,確認入帳後訂單自動更新。六、等第一次撥款進帳時,把撥款金額與手續費和後台明細核對一次,之後每月固定對帳。
瑪尼國際自己的主機續約、開通與網址註冊收款就是這樣做的。客人在自家的 LINE BOT 裡選好要續約的主機或網址,拿到付款連結後到綠界付款頁完成付款,網站一律等綠界伺服器端的通知回來、檢查碼驗證通過,才更新服務狀態並在 LINE 上回覆「付款完成」——客人刷完卡直接關掉 LINE,服務照樣會開通。LINE 這一段的開發範圍怎麼估,見LINE BOT 開發費用怎麼算。
我們實際碰到的限制也寫出來:以我們目前的綠界合約,外國信用卡無法刷,所以海外客戶改走國際電匯,由人工確認入帳後開通。這就是第二節第 3 點要在申請前確認的原因——限制本身不難處理,難的是上線後才發現,客人已經付不了款。網站本身上線前的檢查項目,另見網站上線前檢查清單。
瑪尼國際成立於 2004 年,深耕逾 20 年、服務逾 500 家企業,從網頁設計、購物車與金流程式、主機與 SSL,到上線後的網站代管都由同一個團隊負責,付款出問題時只有一個窗口,這就是我們的一條龍服務。
常見問題
Q:綠界金流串接要準備什麼?
要準備三樣東西:以貴公司名義申請的綠界會員與特約商店資格(商務身分需負責人身分證件、公司存摺封面、公司設立登記證明與環境照片)、一個程式能新增訂單並接收付款通知的網站,以及一支從外部連得到、使用 80 或 443 埠的付款通知網址。審核期間可以先用綠界的測試環境把整個流程做完,審核通過後再換上正式的特店編號與金鑰。
Q:綠界金流串接審核要多久?
依綠界客服中心的說明,商務身分的驗證需 2~5 個工作日(不含例假日);個人身分與特約賣家的審核天數,以綠界當下的規定為準。審核時間不必空等,同一段時間可以在測試環境完成串接與測試,審核一通過就能切換正式參數上線。
Q:綠界金流串接後,客人付了款訂單卻沒更新怎麼辦?
先查網站的付款通知網址(ReturnURL)有沒有收到綠界的通知、有沒有回應 1|OK。常見原因是通知網址帶了非標準埠、被防火牆或登入保護擋住,或程式回應的字串不對。綠界沒收到正確回應時,會隔 5~15 分鐘重送,當天共重送四次;同時可以用查詢訂單 API 補查這筆交易的付款狀態,再更新訂單。