WordPress 串接 LINE Pay：WooCommerce 金流設定完整教學

台灣幾乎人人有 LINE，LINE Pay 自然成為電商網站不能忽略的付款選項。

對 WordPress 網站來說，多一個 LINE Pay 就是少一個顧客在結帳頁離開的理由。這篇文章整理從申請商家到完成串接的完整流程，不管你是用 WooCommerce 外掛還是想自己接 API，都能找到對應的路徑。

如果你還沒把 WooCommerce 主流程建好，先讀支柱文：WooCommerce 完整教學（Pillar）。

若你現在正在整理台灣金流配置，也建議一起搭配這三篇：

LINE Pay 商家申請

在串接之前，你需要先成為 LINE Pay 的合作商家。

誰可以申請

有統編的公司行號：準備營業登記證和稅籍登記即可
個人商店（無統編）：需要能證明有營業事實，例如網路賣家、個人創作者
限制：遞延性產品（儲值、課程、會員）不能用個人商店申請，需要提供履約保證文件

收款帳戶的規則：獨資企業可以用負責人個人帳戶，合夥或股份有限公司只能用公司銀行帳戶。

費率與結算

項目	說明
標準手續費	約 3%
優惠費率	2.31%（需聯繫 LINE Pay 業務申請）
結算週期	7 個工作天撥款

申請流程

前往 LINE Pay 商家申請頁面
填寫公司 / 商店資料
上傳營業登記相關文件
等待審核（LINE Pay 審核 + 一卡通審核，各需 5–15 個工作天）
審核通過後，進入商家後台取得串接金鑰

整體流程大約 2–4 週，建議提早申請。

方式一：WooCommerce 外掛串接（推薦）

如果你的 WordPress 已經裝了 WooCommerce，用外掛是最快的方式。

外掛選擇

免費方案：Pay with LINE Pay

WordPress.org 官方收錄的外掛，最新版本 v1.3.3（2025 年 11 月更新），支援 WooCommerce 區塊結帳，開源免費。

付費方案：LINE Pay Pro for WooCommerce

由 cloudwp 團隊開發，台灣在地支援，月費 NT$399，年費 NT$4,788。適合需要進階功能或中文客服的商家。

設定步驟

以免費外掛 Pay with LINE Pay 為例：

第一步：安裝外掛

在 WordPress 後台 → 外掛 → 安裝外掛，搜尋「Pay with LINE Pay」，安裝並啟用。

第二步：取得 LINE Pay 金鑰

登入 LINE Pay 商家後台，進入「管理付款連結」→「管理連結金鑰」，你會看到兩組資訊：

Channel ID：商家識別碼
Channel Secret Key：API 驗證金鑰

第三步：設定外掛

在 WooCommerce → 設定 → 付款，找到 LINE Pay，點進去填入：

Channel ID
Channel Secret Key
選擇環境（Sandbox 測試 / Production 正式）

第四步：測試

建議先用 Sandbox 模式跑一次完整的付款流程，確認訂單狀態能正確更新後，再切換到正式環境。

第五步：上線

切換到 Production，開啟 LINE Pay 付款方式，顧客在結帳頁就能看到 LINE Pay 選項了。

方式二：直接用 LINE Pay API

如果你的 WordPress 不是用 WooCommerce（例如 Headless WordPress 或自訂購物流程），可以直接串接 LINE Pay Online API v3。

付款流程三步驟

LINE Pay 的付款不是一次完成，而是分三步：

Step 1：Request API — 建立付款請求

網站後端向 LINE Pay 發送付款資訊（金額、商品名稱、回調網址），LINE Pay 驗證後回傳一個付款網址。你把使用者導向這個網址，他就會看到 LINE Pay 的付款畫面。

此時交易只是「Reserved」狀態，LINE Pay 後台還看不到。

Step 2：使用者確認付款

消費者在 LINE App 裡確認付款。注意，這只是「同意支付」，還沒有真正扣款。

確認後，LINE Pay 會呼叫你在 Step 1 設定的 confirmUrl。

Step 3：Confirm API — 完成交易

你的後端收到 confirmUrl 回調後，執行 Confirm API。如果設定了自動請款（capture=true），這一步完成後就正式扣款，交易進入 Completed 狀態。

開發注意事項

伺服器的 IPv4 位址必須加入 LINE Pay 白名單
API 請求需要 HMAC 簽名驗證
務必在 Sandbox 環境測試完整流程
處理異常情境：confirmUrl 回調失敗時，交易會卡在「已認證但未確認」狀態，需要有手動補確認的機制

技術資源

LINE Pay 開發者文件：https://developers-pay.line.me/
LINE Pay API v3 Reference：https://pay.line.me/documents/online_v3_cn.html

Cloudflare 用戶必讀：callback 可能被擋

這是很多人踩過的坑，值得特別拉出來講。

LINE Pay 的 Confirm 流程依賴 server-to-server 的 callback。如果你的網站在 Cloudflare 後面，而且開了 Under Attack Mode 或 Bot Fight Mode，LINE Pay 的回調請求可能會被當成機器人攔掉。

結果就是：顧客付款成功了，但你的網站訂單還停在「待付款」。

解法

在 Cloudflare WAF Rules 中，針對金流 callback URL 設定 Bypass 規則：

URI contains wc-api

或者針對 LINE Pay 的 confirmUrl 路徑做排除。這樣金流回調能正常進站，其他頁面仍然維持 Cloudflare 保護。

詳細做法可以參考我之前寫的 Cloudflare 與綠界金流的筆記，原理完全一樣。

LINE Pay vs 綠界 vs 藍新：怎麼選

	LINE Pay	綠界 ECPay	藍新 NewebPay
手續費	3%（優惠 2.31%）	約 2.75%–3%	約 2.8%–3%
支付方式	LINE Pay 錢包	信用卡、ATM、超商等	信用卡、ATM、超商等
覆蓋範圍	LINE 用戶	全通路	全通路
最適合	高頻小額、LINE 生態圈	需要多元支付的電商	需要多元支付的電商

LINE Pay 不能取代完整金流方案。如果你的產品需要信用卡分期、ATM 轉帳、超商代碼繳費，還是需要搭配綠界或藍新。

最理想的組合是：綠界或藍新當主要金流（覆蓋所有支付方式），再加上 LINE Pay 當加速器（降低行動端結帳摩擦）。

常見問題

LINE Pay 付款成功但 WooCommerce 訂單沒更新？

最常見原因是 Cloudflare 或其他 WAF 擋掉了 callback。檢查 Cloudflare Security Events 有沒有被攔截的 POST 請求，針對 callback URL 做 Bypass。

沒有 WooCommerce 可以用 LINE Pay 嗎？

可以，但需要自己用 LINE Pay API v3 開發付款流程。技術門檻較高，適合有開發能力的團隊。

個人賣家可以申請嗎？

可以，LINE Pay 接受無統編的個人商店申請，但需要能證明有營業事實。遞延性產品（課程、儲值、會員）除外。

Sandbox 測試一定要做嗎？

強烈建議。LINE Pay 的付款流程有三個步驟，任何一步出問題都會導致訂單異常。先在 Sandbox 跑通整個流程，再切到正式環境。

結論

LINE Pay 串接 WordPress 的技術門檻不高，尤其是走 WooCommerce 外掛的路線，裝完外掛、填入金鑰、測試一輪就能上線。

真正要注意的反而是周邊配套：Cloudflare 的 callback 規則、異常訂單的補救機制、以及金流方案的整體搭配。把這些想清楚，LINE Pay 就能成為提升轉換率的有效工具。