SHOPLINE Payments 串接教學 2026|取號、Webhook 設定到付款方式一次搞懂

目錄


完成審核後,要怎麼把 SHOPLINE Payments 串接到自己的商店、開始收信用卡、LINE Pay 與 Apple Pay?這篇會帶你從 SHOPLINE Payments 後台拿到四組金鑰、設定 Webhook,一路到付款方式費率、撥款規則一次搞懂,照著做就能讓結帳頁正式開始收款。

SHOPLINE Payments 串接前,要先拿到這四組金鑰

串接的核心,就是從 SHOPLINE Payments 後台取得下面四組資料,再填回你的商店。先認識它們各自是什麼:

金鑰 用途 取得方式
Merchant ID 商家識別碼 註冊完成即有,設定/概覽頁可見
Client Key 主要金鑰(多以 pk_ 開頭) 系統預設一組
API Key 連線金鑰(多以 sk_ 開頭) 首次需手動新增
Sign Key Webhook 簽章金鑰 新增 Webhook 時產生

SHOPLINE Payments 取號三步驟

步驟一・進入「設定 › 開發者管理」

登入 SHOPLINE Payments 後台,從左側選單進入「設定」,在列表中找到「開發者管理」,點右側「查看詳情」。進入後可做兩件事:金鑰管理(取得 Client Key 與 API Key)與 Webhook 管理(設定事件訂閱、接收即時交易狀態通知)。Merchant ID 則在「設定/概覽」頁就能看到,是一組長串數字,先整組複製保存。

SHOPLINE Payments 後台設定頁,開發者管理查看詳情位置
在「設定」頁找到「開發者管理」,點「查看詳情」進入

步驟二・金鑰管理:取得 Client Key 與 API Key

進入開發者管理後預設停在「金鑰管理」頁,這裡要做兩件事:

  1. 複製 Client Key:類型顯示「Client Key」的那一列即是,多以 pk_ 開頭。點旁邊的眼睛圖示顯示完整金鑰後複製。
  2. 新增 API Key:首次串接按右上角「新增金鑰」,輸入辨識名稱(例如「官網」),確認後產生一組以 sk_ 開頭的 API Key。
SHOPLINE Payments 金鑰管理頁,Client Key 與 API Key
「金鑰管理」頁取得 Client Key、新增 API Key
💡 一個帳號最多可建立 5 組 API Key,可為不同商城各自命名。新增的金鑰可刪除,刪除後約 24 小時失效;預設標準金鑰不可刪除。

步驟三・Webhook 管理:新增 Webhook、取得 Sign Key

切到「Webhook 管理」分頁,按右上角「新增 Webhook」,在跳出的視窗填入:

  • Webhook 名稱:自行命名,例如「官網」。
  • URL:填入你商店的 Webhook 接收網址(格式依你使用的金流外掛而定,見下一段)。
  • 訂閱事件:建議全部勾選,含結帳交易(session.created / expired / pending / succeeded)與付款交易(trade.succeeded),避免日後要重設。
  • Sign Key:留空讓系統自動產生,送出後會顯示完整 Sign Key,複製保存。
SHOPLINE Payments Webhook 管理,新增 Webhook
「Webhook 管理」新增 Webhook
SHOPLINE Payments Webhook 訂閱事件與 Sign Key 設定
勾選訂閱事件、由系統自動產生 Sign Key
💡 一個帳號最多可同時支援 20 個 Webhook,不用擔心不夠用。

把四組金鑰串進你的商店

取得 Merchant ID、Client Key、API Key、Sign Key 之後,回到你的商店後台,在 SHOPLINE Payments 金流設定的對應欄位逐一貼上,並把上一步在後台填的 Webhook URL 對應好,即可啟用結帳頁的 SHOPLINE Payments 付款。

💡 貼上時直接從後台複製,不要手動輸入,避免多帶空白或漏字導致驗證失敗。四組金鑰本身不會因為貼錯而失效,驗證沒過時回後台重新複製貼上即可。
⚠️ 這段「填到哪個欄位、Webhook URL 的完整格式」會依你 WooCommerce 使用的 SHOPLINE Payments 外掛而不同。等你告訴我用哪一個,我再把實際欄位位置與 URL 寫成精準步驟。

SHOPLINE Payments 支援的付款方式(網路開店/社群開店)

串接完成後,結帳頁可同時提供以下付款方式。每種的手續費、付款時效、撥款天數、退款方式都不同,先看官方整理圖,再往下看逐項說明(費率以官方最新公告為準):

SHOPLINE Payments 台灣台幣商店 網路開店/社群開店系統付款方式介紹(2026.05 版)
SHOPLINE Payments 網路開店/社群開店系統付款方式(2026.05 版)

信用卡(含 Apple Pay)

支援國內外 Visa/Mastercard/JCB/銀聯卡,免跳轉、直接在結帳頁輸入卡資,付款時效 15 分鐘、狀態即時更新。手續費:國內 2.2%、國外 3.5%;Apple Pay 同樣為國內 2.2%、國外卡 3.5%;銀聯卡手續費同國內。撥款:當天帳戶餘額滿 NT$2,000,約 4 個工作天後撥款。退款由 SHOPLINE 後台一站式管理。

信用卡分期付款

免跳轉、選擇期數後輸入卡資。合作銀行:中信、國泰、玉山、台新、星展(含原花旗)、永豐、聯邦、凱基、滙豐(支援銀行持續增加,實際依商店審核而定;永豐不支援 18/24 期)。服務費率:3 期 2.4%、6 期 3.7%、9 期 5.8%、12 期 6.8%、18 期 9%、24 期 10.8%。撥款約 4 個工作天。注意:金管會規定「一次付清」不可加收手續費,只有分期能轉嫁費用;開啟分期後顧客選此付款就一定是分期、無法一次付清,建議把「一次付清」與「分期」設成兩個獨立選項。

ATM 銀行轉帳

提供虛擬轉帳帳號予消費者匯款,系統自動對帳、約 1 分鐘更新付款狀態。繳款期限可自行設定 1~60 天。手續費每筆 1%(最低 10 元)。撥款約 4 個工作天。ATM 無線上退款機制,需店家線下轉帳返回款項。

中租 zingala 銀角零卡

先買後付(BNPL),顧客跳轉至中租頁面完成付款、免綁卡,付款時效 24 小時。支援 8 種分期,費率隨期數遞增:1 期 2.0%、3 期 2.6%、6 期 4.0%、12 期 7.0%、18 期 9.5%、24 期 12.0%、30 期 14.0%、36 期 17.0%。撥款約 4 個工作天,退款由 SHOPLINE 後台一站式管理。

LINE Pay

台灣最普及的行動支付,顧客跳轉至 LINE Pay 頁面完成付款,付款時效 35 分鐘。SHOPLINE 店家享專屬優惠手續費。撥款:當天餘額滿 NT$2,000,約 5 個工作天後撥款。退款由 SHOPLINE 後台一站式管理。

街口支付

台灣主要電子支付之一,顧客跳轉至街口頁面完成付款,付款時效 20 分鐘。手續費 2.5%。撥款較彈性:店家可至街口後台自行決定請款週期(每日/五日/十日/每月),請款週期後一天撥款。需在 SHOPLINE Payments 審核通過後「單獨申請開通」,退款由 SHOPLINE 後台一站式處理。

AFTEE 先享後付

日本 Net Protections 推出的先買後付服務,顧客跳轉至 AFTEE 頁面完成付款,付款時效 60 分鐘。手續費 2.415%。撥款:當天餘額滿 NT$2,000,約 17 個工作天後撥款(較長)。僅支援身分為「公司戶」的店家申請,退款由 SHOPLINE 後台一站式管理。

3D 驗證(內建、PCI-DSS 認證)

SHOPLINE Payments 預設啟用 3D 驗證,並通過 PCI-DSS 安全認證,能降低盜刷與拒付風險,官方不建議自行關閉。

(補充)零售 POS 系統付款方式

如果你除了線上商店、還有實體門市或快閃店,SHOPLINE Payments 也提供零售 POS 系統收款,分成「刷卡機」與「LINE Pay POS」兩種:

SHOPLINE Payments 零售 POS 系統付款方式介紹(2026.02 版)
SHOPLINE Payments 零售 POS 系統付款方式(2026.02 版)
  • 刷卡機:支援實體卡感應支付(國內外 Visa/Mastercard/JCB)與行動支付(Apple Pay/Samsung Pay/Google Pay)。手續費國內 2.2%、國外 3.5%(含稅)。機型月租:A910 每月 $800、A80 每月 $500(不滿月以月計)。約 4 個工作天撥款,支援 45 天內交易退款。
  • LINE Pay POS:以 POS 掃描槍或 iPad 相機掃描顧客付款碼(支援國內 Visa/Mastercard/JCB/LINE Points),無租賃費用,享 SHOPLINE 店家專屬優惠手續費。撥款週期為「週結」(每週一至日交易,隔週週二撥款),支援 60 天內交易退款。

進階:啟用 Apple Pay(網域驗證)

想讓 iPhone/Mac 訪客一鍵結帳,付款選項啟用 SHOPLINE Payments 後還要做一次「網域驗證」——Apple 規定只有驗證過的網域才能在前台顯示 Apple Pay。步驟:

  1. 登入 SHOPLINE Payments 後台,左側「設定」→「域名設定」。
  2. 點「增加網域」,輸入你的網域(不含 https://,例如 yourstore.com)。
  3. 勾選「Apple Pay 網域驗證」後送出。
  4. 回到列表點「重新整理」,網域旁的提示圖示消失即代表驗證成功。
💡 驗證失敗常見原因:HTTPS/SSL 異常、填的網域與實際商店不一致(www 差一個字也不行)、DNS 還在生效(剛換網域等 24~48 小時)、或 /.well-known/apple-developer-merchantid-domain-association 路徑被 CDN/防火牆擋下。前台只有用 Safari、且裝置已綁卡才會顯示 Apple Pay 按鈕。

撥款、手續費與提款規則

  • 撥款時程:信用卡、分期、ATM、中租約 4 個工作天撥款;LINE Pay 約 5 個工作天;AFTEE 約 17 個工作天;街口依你在街口後台自訂的請款週期。實際以後台對帳單為準。
  • 自動提款門檻:台灣商店預設當天帳戶餘額滿 NT$2,000 才撥款,不足會累積到下次。
  • 撥款手續費:綁台新銀行帳戶享不限次數 0 元手續費;綁其他銀行跨行提領每次酌收 NT$15。
  • 手動提款:到後台「帳戶管理介面 › 提款」可自行「發起提款」或調整自動提款週期與最低金額。
  • 保證金:依商店風險等級可能按比例收取,釋放週期與比例隨等級而定,由 SHOPLINE 另行通知。

常見問題 FAQ

Q:一定要設 Webhook 嗎?不設會怎樣?

要。沒有 Webhook,SHOPLINE Payments 完成付款後無法即時通知你的商店,訂單狀態就不會自動更新。第一次串接時就把 Webhook 設好,結帳交易與付款交易兩個事件群組都勾選。

Q:API Key 可以開幾組?不小心刪掉怎麼辦?

一個帳號最多 5 組,不同用途可各自建立。新增的金鑰可刪除,刪除後約 24 小時失效;預設標準金鑰不可刪除。若刪到正在用的那組,重新新增一組並回商店後台更新即可。

Q:哪些付款方式支援線上退款?

信用卡、信用卡分期、中租 zingala、LINE Pay、街口支付、AFTEE 都可在 SHOPLINE 後台一站式退款;ATM 銀行轉帳無線上退款機制,需店家另外線下轉帳返回款項。

Q:AFTEE 先享後付有什麼限制?

AFTEE 僅支援身分為「公司戶」的店家申請,手續費 2.415%,撥款約 17 個工作天,比其他付款方式久,安排金流時要把這段時間差算進去。

Q:撥款多久?最低多少才會撥?

信用卡類約 4 個工作天、LINE Pay 約 5 天、AFTEE 約 17 天、街口依自訂請款週期。台灣商店須當天帳戶餘額滿 NT$2,000 才撥款,不足累積到下次;綁台新免撥款手續費,綁他行每次 NT$15。想自己控制時機可到後台「提款」頁手動發起。

Picture of 電商防護盾

電商防護盾

在這裡會分享關於電商的基礎知識,帶領你了解電商世界的全貌。 當你掌握電商必備技能、了解經營電商可能會發生的狀況後,如同穿上一層防護甲,不只能降低經營電商失敗的機會,也能加快電商成功速度。

Picture of 電商防護盾

電商防護盾

在這裡會分享關於電商的基礎知識,帶領你了解電商世界的全貌。 當你掌握電商必備技能、了解經營電商可能會發生的狀況後,如同穿上一層防護甲,不只能降低經營電商失敗的機會,也能加快電商成功速度。

免費課程

站長資訊

Picture of 電商防護盾

電商防護盾

在這裡會分享關於電商的基礎知識,帶領你了解電商世界的全貌。 當你掌握電商必備技能、了解經營電商可能會發生的狀況後,如同穿上一層防護甲,不只能降低經營電商失敗的機會,也能加快電商成功速度。

最新文章

文章分類

站內搜尋

追蹤我們

相關文章

Scroll to Top