KPay Payment Gateway 與 WooCommerce 對接服務完整指南 - TAN-studio 香港網頁設計 - 香港HK WordPress, OpenCart, Shopify...

在香港電商市場日益蓬勃的今天，選擇合適的支付網關對於 WooCommerce 商店來說至關重要。KPay Payment Gateway 作為一家本地化的支付解決方案，提供多種支付方式，包括 FPS（轉數快）、信用卡（Visa/MasterCard）、銀聯、AlipayHK、WeChat Pay HK 等，深受中小企歡迎。它支援 T+1 結算、即時數據報表，並與超過 70 種 POS 及會員系統無縫整合，適合從線下擴展到線上的商家。

WooCommerce 是 WordPress 最受歡迎的電商插件，全球超過 500 萬網站使用，它靈活易用，支援數百種支付網關擴充。然而，截至 2025 年 11 月，KPay 官方並未推出專屬的 WooCommerce 插件或公開 API 文檔，這意味著無法像 Stripe 或 PayPal 那樣一鍵安裝直接對接。

本文將詳細說明 KPay 的特色、對接現況，以及實用替代方案與自訂整合方法，幫助你順利在 WooCommerce 商店導入可靠的香港本地支付體驗。

KPay Payment Gateway 的核心優勢

KPay Group（官方網站：kpay-group.com）專注為香港商家提供一站式支付生態系統，主要亮點包括：

• 多樣支付方式：支援 FPS、信用卡、銀聯、Alipay、WeChat Pay、BoC Pay 等本地熱門選項，涵蓋線上線下。
• 快速結算：T+0/T+1/T+2 結算選擇（視行業而定），資金到賬迅速。
• 低成本導入：無需昂貴硬件，透過 QR Code、Payment Link 或 App 即可收款。
• 數據管理：商家後台提供即時交易記錄、自動對賬與報表下載。
• 安全合規：符合 PCI DSS 標準，支援 18 種貨幣跨境轉賬。

KPay 已服務超過 72,000 商家，特別適合餐飲、零售及服務業從實體店轉型線上。

WooCommerce 支付網關機制簡介

WooCommerce 內建「付款」設定頁面，允許安裝官方或第三方插件來擴充支付方式。常見對接類型：

• 官方插件：如 WooPayments、Stripe、PayPal，一鍵啟用。
• 重定向式：跳轉到支付頁面（如 Alipay）。
• 直接式：在本站完成支付（需 SSL 證書）。
• 自訂網關：透過繼承 WC_Payment_Gateway 類別開發。

理想情況下，KPay 若有插件，只需上傳 ZIP 檔、輸入 Merchant ID 及 Secret Key 即可啟用。

KPay 與 WooCommerce 對接現況與挑戰

遺憾的是，KPay 官方未在 WooCommerce 擴充市場或 WordPress.org 上發布專屬插件，也未公開 developer API 文檔（developer 頁面為 404）。 其支付網關主要針對 POS 系統整合，線上部分多依賴「Payment Link」功能——商家手動或透過後台生成支付連結發給客戶。

這導致直接對接 WooCommerce 的難度較高，常見問題：

• 無法自動返回支付狀態。
• 訂單需手動確認，影響自動化流程。
• 无公開 API，無法使用 WooCommerce REST API 串接。

實用對接方案（2025 年最新）

雖然無官方插件，但以下方法可實現功能對接：

方案 1：使用 KPay Payment Link（最簡單，無需開發）

1. 在 WooCommerce 後台啟用「貨到付款」或「銀行轉賬」作為暫時網關。
2. 客戶下單後，進入訂單詳情，手動在 KPay 商家後台生成 Payment Link。
3. 透過 WooCommerce 郵件模板或插件（如 Automated Email）自動發送連結給客戶。
4. 客戶點擊連結完成支付，KPay 通知到賬後手動標記訂單為「已完成」。

優點：零成本，適合日訂單量 < 50 的小型店。 缺點：非自動化，易出錯。 推薦插件：WooCommerce Order Notes 或 YITH Automatic Email。

方案 2：自訂 Payment Gateway 插件（需 API 接入）

如果你已向 KPay 銷售團隊申請到私有 API（部分大型商家可獲取），可開發自訂插件：

class WC_KPay_Gateway extends WC_Payment_Gateway {
    public function __construct() {
        $this->id = 'kpay';
        $this->method_title = 'KPay Payment';
        // 初始化表單欄位、圖標等
    }
    
    public function process_payment( $order_id ) {
        $order = wc_get_order( $order_id );
        // 呼叫 KPay API 產生支付請求
        // wc_add_notice( '支付成功', 'success' );
        $order->payment_complete();
        return array('result' => 'success', 'redirect' => $this->get_return_url( $order ));
    }
}
add_filter( 'woocommerce_payment_gateways', function($gateways) {
    $gateways[] = 'WC_KPay_Gateway';
    return $gateways;
});

步驟：

• 聯繫 KPay 商務申請 API Key。
• 參考 WooCommerce 官方文件開發。
• 測試沙盒環境，確保 webhook 回傳訂單狀態。

方案3: 使用TAN-studio 所開發的KPay API 的插件（推薦使用）

結語與建議

KPay 是優秀的本地支付工具，但目前與 WooCommerce 的對接仍需依賴 Payment Link 或私有 API，適合已與 KPay 深度合作的商家。對於新手或追求自動化的店主，建議選擇我們公司所提供的KPay API 與 Woocommerce對接服務，既省時又穩定。

有其他支付問題歡迎留言討論，讓我們一起打造高效香港電商商店！🚀