WooCommerce 綠界 Apple Pay 怎麼串接?一次看懂開通設定與付款測試

要在 WooCommerce 導入綠界 Apple Pay,核心流程是先確認綠界賣家帳號已具備信用卡與 Apple Pay 收款資格,再安裝綠界官方或經確認相容的 WooCommerce 模組,前往「WooCommerce>設定>付款」啟用綠界付款服務。若商店已使用 LINE Pay 外掛,通常仍可另外加入 Apple Pay,但兩者是不同付款服務,不能因 LINE Pay 已上線就直接推定 Apple Pay 外掛一定相容;正式啟用前,必須確認 WordPress、WooCommerce、PHP 版本、結帳頁架構及綠界商店代號設定,並在測試環境完成建立訂單、付款通知、訂單更新與退款流程驗證。

WooCommerce 綠界 Apple Pay 的運作方式

WooCommerce 綠界 Apple Pay 並不是單純在結帳頁放上一個按鈕,而是由 WooCommerce 建立訂單後,將交易金額、商店訂單編號、付款方式、回傳網址及驗證資料送往綠界。消費者進入付款流程後,再透過支援的 Apple 裝置、瀏覽器與 Wallet 完成授權。

付款完成後,綠界會將交易結果傳送至商店設定的付款結果通知網址。網站收到通知後,應驗證資料完整性與檢查碼,再更新 WooCommerce 訂單狀態。技術上不能只依賴消費者付款後返回網站的頁面,因為使用者可能關閉瀏覽器、網路中斷,或未成功回到訂單完成頁。

綠界曾公告配合 2025 年 4 月 1 日起的金流收費調整與 Apple Pay 收款功能變更,同步調整相關串接規格。實際可用資格、費率及最新參數仍應以綠界會員後台、合約內容與官方技術文件為準,不宜只依照舊版教學設定。

啟用前應確認的帳號與網站條件

綠界商店資格

商家應先完成綠界賣家註冊、身分或公司資料審核,並確認信用卡及 Apple Pay 服務狀態。部分服務可能涉及特約賣家、站內付版本、風險審查或不同合約條件,即使後台看得到付款選項,也不代表正式環境已具備完整交易權限。

如果綠界已通知 Apple Pay 全面開放,商家仍應登入自己的會員後台確認,因為帳號審核、產業類別、交易額度與服務啟用狀態可能不同。不要直接複製其他商店的 MerchantID、HashKey 或 HashIV,也不可將正式金鑰公開在網頁原始碼、GitHub 或錯誤紀錄中。

WooCommerce 系統條件

網站應使用有效的 HTTPS 憑證,並確認 WordPress、WooCommerce、佈景主題與金流外掛版本相容。若網站使用新版區塊式結帳頁,也要檢查外掛是否支援 Checkout Blocks;部分舊版付款模組只支援傳統 shortcode 結帳頁。

快取、資安防火牆、Cloudflare 規則及主機 ModSecurity 也可能攔截付款通知。測試時應確認綠界伺服器可以連線至付款通知網址,而且該網址不會被登入驗證、維護模式、快取頁面或國家封鎖規則阻擋。

消費者端條件

Apple Pay 是否顯示,亦可能受到裝置、瀏覽器、Wallet 卡片、發卡銀行及付款頁面條件影響。商家不應只用單一桌上型瀏覽器測試,也不能看到信用卡付款正常,就直接認定 Apple Pay 一定正常。

WooCommerce 綠界付款功能比較

常見付款方式分析表

付款方式 適合情境 商家應注意事項 與 WooCommerce 的整合重點
Apple Pay 行動購物、重視快速結帳的消費者 裝置與 Wallet 必須支援,並確認帳號權限 測試付款通知、訂單狀態與相容性
信用卡一次付清 多數一般網路商店 費率、拒付、風險控管與退款 避免重複建立訂單與重複請款
信用卡分期 較高單價商品 適用銀行、期數與商家資格 商品頁與結帳頁資訊應一致
ATM 虛擬帳號 不使用信用卡的消費者 繳費期限及逾期訂單處理 付款前不可誤設為已完成
超商代碼繳費 熟悉超商付款的台灣消費者 代碼期限及付款手續費 收款與出貨狀態應分開管理
超商取貨付款 實體商品與超商物流 未取貨、退件及物流費用 金流模組需搭配物流模組
LINE Pay 台灣行動支付使用者 屬於獨立服務與外掛 不代表可取代 Apple Pay 串接
Stripe 加 PayPal 跨境代購或海外客群 幣別、提領、爭議款與稅務 Stripe 常用於刷卡與 Apple Pay,PayPal 可涵蓋既有帳戶用戶

對台灣本地電商而言,綠界的優勢是能整合信用卡、ATM、超商付款與物流等在地服務。企業 B2B 若重視對帳、電子發票與台灣付款習慣,也可評估在地金流;海外客群比例高時,則可比較 Stripe、PayPal 與綠界在幣別、付款覆蓋率及營運成本上的差異。

綠界 WooCommerce 外掛安裝與設定

安裝付款模組

可先由 WordPress 後台進入「外掛>安裝外掛」,搜尋綠界相關 WooCommerce 付款模組;也可以前往綠界官方模組下載頁取得 ZIP 檔,再使用「上傳外掛」完成安裝。搜尋時可能看到 ECPay Payment for WooCommerce、Ecpaywoocommerce 或其他第三方名稱,安裝前必須核對開發者、更新日期、支援版本及官方說明。

外掛啟用後,進入「WooCommerce>設定>付款」,一般可看到綠界多元付款、定期定額或超商取貨付款等選項。不同版本的選單名稱可能是「綠界科技」分頁或付款方式清單,應以目前安裝版本的介面為準。

填入綠界介接資料

設定頁通常需要輸入商店代號及相關驗證資料,並選擇測試或正式環境。測試資料與正式資料不能混用,切換正式環境前也應再次檢查付款通知網址、訂單編號規則、幣別與金額。

HashKey、HashIV 等機密資料應只保存於伺服器端。管理員帳號需要啟用高強度密碼與雙因素驗證,避免攻擊者登入後台竄改收款設定或付款導向位置。

啟用 Apple Pay

在綠界付款設定中勾選 Apple Pay 或允許的付款服務後儲存。如果介面沒有 Apple Pay,常見原因包括外掛版本過舊、帳號尚未開通、模組未支援最新規格,或目前使用的是第三方簡化版外掛。

曾購買 LINE Pay 外掛的商家若想加入 Apple Pay,應先向 Apple Pay 外掛供應商提供目前的 WordPress、WooCommerce、PHP、佈景主題、結帳外掛及 LINE Pay 外掛版本,請對方書面確認相容性。即使綠界已開通服務,也不等於任何標示為「Apple Pay for WooCommerce」的第三方產品都可直接使用。

綠界 API 串接的技術重點

依官方文件建立交易

具備開發能力的商家,可以使用綠界 API 或官方 SDK 建立訂單、接受付款通知及查詢交易。綠界提供 PHP、Java、C# 等開發資源,最新全方位金流技術文件可由綠界開發者網站查詢:

首頁

一套完整的綠界金流串接教學,不能只示範如何送出訂單,還應涵蓋參數排序與編碼、檢查碼、交易通知驗證、重複通知處理、金額核對、交易查詢、取消與退款,以及測試環境切換。

正確處理付款通知

網站收到付款通知後,至少應核對商店訂單編號、綠界交易編號、交易金額、付款狀態及檢查碼。只有伺服器驗證成功後,才能把 WooCommerce 訂單由待付款更新為處理中或已完成。

通知端點還要具備冪等性。同一筆成功通知即使收到兩次,也只能更新同一張訂單,不能重複扣庫存、重複發票或寄送兩次商品。原始通知內容可以保存於受保護的紀錄中,但信用卡敏感資料與金鑰不可寫入一般除錯日誌。

綠界 10200141 的處理原則

開發者搜尋「綠界 10200141」時,通常是希望查明交易回傳代碼或介接錯誤。由於錯誤代碼的適用產品、訊息定義及處理方式可能隨文件更新,不能僅依照論壇舊文章判斷。

正確做法是保存發生時間、MerchantTradeNo、TradeNo、使用環境、付款方式與綠界回傳訊息,再到最新官方文件、會員後台或客服管道核對「綠界 10200141」的正式定義。回報問題時不可公開 HashKey、HashIV、完整個資或付款憑證。

Apple Pay、Google Pay 與其他平台需求

綠界 Google Pay 不可直接視為 Apple Pay 附加功能

不少商家會詢問付費 Pro 版能否同時增加 Apple Pay 與綠界 Google Pay。兩者屬於不同數位錢包與技術規格,Apple Pay 已可使用,不代表 Google Pay 必然由同一個 WooCommerce 模組支援。

評估綠界 Google Pay 時,應分別向綠界及外掛開發者確認商家資格、API 規格、支援裝置、結帳頁呈現方式、正式環境開通程序與退款機制。外掛頁面若只寫「行動支付」,也不代表包含所有數位錢包。

OpenCart 綠界不能直接安裝於 WooCommerce

OpenCart 綠界模組是為 OpenCart 架構開發,不能直接安裝到 WordPress。即使兩個模組都使用綠界全方位金流 API,其訂單模型、事件機制、資料庫與後台設定仍不相同。

商店若從 OpenCart 搬遷至 WooCommerce,需要重新設定金流模組、通知網址與訂單編號,並保留舊站交易資料供退款及對帳。不要直接複製外掛程式碼或資料表設定,以免新舊訂單編號衝突。

Flutter 綠界適合自有 App 串接

Flutter 綠界通常用於自有行動 App,而不是直接取代 WooCommerce 外掛。若 App 與 WooCommerce 共用商品及訂單,建議由後端建立交易並管理敏感金鑰,Flutter 前端只取得必要的付款流程資訊。

App 端完成付款畫面不應直接被視為收款成功。最終狀態仍應由伺服器接收綠界通知、驗證結果後,再同步至 WooCommerce 與 App。如此可降低前端資料被修改、偽造付款結果或訂單狀態不同步的風險。

WooCommerce 超商地圖與 Apple Pay 的分工

WooCommerce 超商地圖屬於物流門市選擇功能,Apple Pay 則屬於金流工具。消費者可以使用 Apple Pay 付款,再選擇超商取貨;也可以選擇超商取貨付款,但兩種流程的訂單狀態與出貨條件不同。

整合 WooCommerce 超商地圖時,應測試門市選擇完成後,門市代號、門市名稱與地址是否正確寫入訂單。若消費者返回結帳頁更換配送方式,系統也必須重新計算運費,避免保留已失效的門市資料。

金流與物流模組可能同時修改 WooCommerce 結帳欄位、JavaScript 或訂單狀態,因此更新其中一個外掛後,應重新測試 Apple Pay、信用卡、超商選店及行動版結帳。

上線前測試與維運檢查

必做測試項目

正式上線前應測試成功付款、取消付款、付款失敗、重複通知、金額不一致、庫存不足、優惠券、含運費訂單、手機結帳與桌面結帳。若商店有訂閱制、預購、退款或多語系功能,也要納入測試。

測試訂單應確認 WooCommerce 訂單狀態、綠界後台交易、庫存、通知信、發票及物流資料一致。退款則須確認外掛支援從 WooCommerce 後台操作,或必須登入綠界後台處理,不可假設按下 WooCommerce 的退款按鈕就一定完成金流退款。

外掛更新原則

正式站更新 WordPress、WooCommerce 或付款模組前,應先備份資料庫與程式檔,並在測試站驗證。若商店使用自訂結帳欄位、會員分級、快取或多幣別外掛,更應避免直接在尖峰時段更新。

商家也應定期查看綠界公告與 API 文件。若介接規格、費率或 Apple Pay 服務條件改變,需同步檢查外掛是否已有相容版本,而不是長期停留在可能存在資安問題的舊版本。

結論

WooCommerce 串接綠界 Apple Pay 的重點,是帳號服務資格、模組相容性、API 通知驗證及完整測試,而不只是勾選付款方式。已使用 LINE Pay 的網站可以評估增加 Apple Pay,但必須將兩套外掛視為獨立服務,逐項確認結帳頁、訂單狀態與付款通知是否衝突。

一般商店可優先使用持續維護的官方模組;有自訂 App、特殊訂單流程或 ERP 整合需求時,再評估綠界 API 與 SDK。所有費率、開通資格、錯誤代碼和支援付款方式,均應以綠界最新公告、會員合約及官方技術文件為準。

常見問題

1. WooCommerce 安裝綠界外掛後就能直接使用 Apple Pay 嗎?

不一定。除了安裝外掛,還要確認綠界商店帳號具備相關收款資格、外掛支援目前的 Apple Pay 規格,並完成正式環境參數及付款通知設定。

2. 已經購買 LINE Pay 外掛,還能再安裝 Apple Pay 外掛嗎?

通常可以同時提供多種付款方式,但仍要由外掛供應商確認版本相容性。兩個外掛若同時修改結帳頁或訂單狀態,可能發生按鈕不顯示、付款方式消失或 JavaScript 衝突。

3. Apple Pay 是否需要另外向綠界申請?

實際程序應以商家的綠界會員後台與合約為準。即使綠界公告全面開放,個別帳號仍可能受到審核狀態、產業別或服務資格影響。

4. 為什麼結帳頁看不到 Apple Pay?

常見原因包括裝置或瀏覽器不支援、Wallet 未設定可用卡片、綠界帳號未啟用、外掛版本過舊、使用區塊式結帳頁但模組不相容,或快取造成舊設定仍被顯示。

5. Apple Pay 付款完成後,訂單為何仍顯示待付款?

可能是付款通知網址無法連線、被防火牆攔截、檢查碼驗證失敗,或訂單編號無法對應。應同時檢查綠界交易紀錄、WooCommerce 日誌及主機連線紀錄。

6. 綠界 10200141 要如何排除?

先保存交易時間、訂單編號、交易編號、測試或正式環境及完整回傳訊息,再依最新官方文件或客服回覆確認綠界 10200141 的定義。不要只按照舊文章修改程式,也不可公開金鑰。

7. 綠界 Apple Pay 可以搭配超商取貨嗎?

可以將付款方式與配送方式分開設計,例如 Apple Pay 付款後選擇超商取貨。商店需同時確認金流成功及 WooCommerce 超商地圖門市資料有效,才可進入出貨流程。

8. 綠界 Apple Pay 與 Stripe Apple Pay 應如何選擇?

台灣本地商店可比較綠界的在地付款、超商物流、對帳與發票整合;跨境商店則可評估 Stripe 的海外卡片、幣別與 Apple Pay 覆蓋。選擇時還要納入費率、退款、爭議款及技術維護成本。

9. 可以把綠界金鑰直接放進 Flutter App 嗎?

不建議。Flutter 綠界串接應由後端保存 MerchantID、HashKey 與 HashIV,App 只負責顯示必要流程。付款成功與否也應由後端驗證綠界通知後決定。

10. 正式上線後還需要定期測試嗎?

需要。WooCommerce、WordPress、PHP、佈景主題、金流與物流模組都會更新,綠界也可能調整 API 規格。每次重大更新後,至少應重新驗證付款、通知、退款、庫存、發票及超商選店流程。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

這個網站採用 Akismet 服務減少垃圾留言。進一步了解 Akismet 如何處理網站訪客的留言資料