綠界金流串接要準備什麼?
特約商店申請、測試環境到正式上線的 5 個階段

作者:邦邦(瑪尼國際 工程師)· 2026 年 11 月 · 閱讀時間約 9 分鐘

綠界金流串接要準備的東西分成三類:以貴公司名義申請的特約商店資格、一個能建立訂單並接收付款通知的網站,以及一支從外部連得到的付款通知網址。真正花時間的不是寫「導到付款頁」那一段,而是審核文件、測試環境裡的 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 件事沒有在申請前想清楚:

  1. 帳號用誰的名義申請。一律以貴公司名義申請、款項撥入公司帳戶,開發廠商只用測試環境或被授權的權限協助。用廠商或員工個人名義申請,日後換廠商、員工離職時,收款帳號會跟著走。
  2. 要開通哪些付款方式。信用卡一次付清、ATM 虛擬帳號、超商代碼是中小企業最常用的組合;分期與綁定信用卡,綠界官網註明要另外聯繫銷售顧問。實際能用哪些,以審核結果與合約為準。
  3. 海外客人刷不刷得到。綠界文件寫明,是否支援海外卡「依照特店是否設定開通海外卡功能而定」。客人有一定比例在海外的,申請時就要問清楚,不要上線後才發現;要不要搭配其他金流或改走 PayPal,判斷方法見綠界、藍新、PayPal 怎麼選。
  4. 撥款節奏能不能接受。綠界官網寫一般賣家的金流代收款項「於付款後 10 日內撥款」,特約賣家則依議定。現金流吃緊的公司,要把這段時間差算進去。
  5. 網站上的商品與交易條件是否完整。申請時要提供販售網址,網站上看得到商品或服務內容、價格、退換貨與聯絡方式,審核比較順利;網站還在改版的,至少先把這幾頁做好。
  6. 誰保管後台帳號與金鑰。綠界後台的登入帳號、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 補查這筆交易的付款狀態,再更新訂單。

網站要開始收款,從哪一步開始?

告訴我們要收哪些付款方式、網站現在用什麼做的、客人有沒有在海外,我們先幫您排好申請與測試的順序,再依需求報價。免付費專線 0800-670000。

免費諮詢 → 看金流串接服務
本站由瑪尼國際自行設計、開發與維運(PHP 8.5 / MySQL 8.4,中華電信光纖機房)。我們同時承接企業官網設計、虛擬主機與網站代管 — 了解服務內容

延伸閱讀GUIDE

查看全部 102 篇文章 →

📞 技術支援(24小時):0921-070-027  |  📞 免費諮詢:0800-670000 📍 411 台中市太平區育賢路366號4樓之2  |  ✉ cody@mani.tw