- 登入
- 註冊
【秒站教學】SHOPLINE Payments 金流完整取號串接流程一次看懂
這篇教學會帶你從 SHOPLINE Payments 後台一路走到秒站後台貼上金鑰完成啟用，搭配官方後台截圖，讓第一次串接的人也能順順跑完。如果你還在比較 SaaS 建站、自架站、和秒站這類一站式服務的差異，這篇也會簡短說明為什麼秒站是現階段最省事的選擇。
內容目錄
顯示
串接 SHOPLINE Payments 前要先準備哪些資料？
在進入操作之前，先看看要從 SHOPLINE Payments 後台拿到哪些東西。
- Merchant ID：商家識別碼，註冊完成就有
- Client Key：主要金鑰，每個商家預設一組
- API Key：連線金鑰，首次使用需要手動新增
- Sign Key：Webhook 簽章金鑰，對應結帳與付款通知
怕用到忘記嗎？可以先點這邊開啟小工具記錄！
三個步驟完成 SHOPLINE Payments 取號
步驟一：找到 Merchant ID
登入 SHOPLINE Payments 後台後，從左側選單進入「設定」，頁面最上方會看到「Merchant Id」欄位，通常是一組長串數字。這是商家識別碼，把它整組複製下來，可以貼到上面的複製工具。
在同一個設定頁面，會看到「開發者管理」的入口，點「查看詳情」進入下一步。這邊也會看到聯絡信箱、授權碼、目前費率、串接商店等其他選項，可以先稍微看一下，方便之後做帳務對照。
步驟二：取得 Client Key 與 API Key
進入「開發者管理」後，預設會停在「金鑰管理」頁面。這邊有兩件事要做：
- 複製 Client Key：註冊完成後系統會預設生成一組，類型欄位顯示「Client Key」的那一列就是，金鑰通常以
pk_****開頭。點旁邊的眼睛圖示可以顯示完整金鑰，按複製貼到筆記上。 - 新增 API Key：首次串接需要按右上角「新增金鑰」，輸入一個辨識用的名稱（例如「官網」「主商城」），按「確認」後系統會產生一組以
sk_****開頭的 API Key。
補充一個重點：一個帳號最多可以建立 5 組 API Key，代表可以為不同商城、不同平台各自建立金鑰，方便日後分辨用途。新增的金鑰可以刪除，刪除後 24 小時會失效，預設的標準金鑰則不可刪除。
步驟三：新增 Webhook 並取得 Sign Key
切到「Webhook 管理」分頁，按右上角「新增 Webhook」。在跳出的視窗中填入：
- Webhook 名稱：自行命名，例如「秒站官網」
- URL：您的URL是： https://您的網址/wc-api/ys_shopline_webhook
不知道怎麼建立？點此輸入您的網址後一鍵複製！
Webhook URL 產生器
輸入你的網站網址，一鍵產生 SHOPLINE Payments Webhook 串接用的完整 URL。
完整 Webhook URL
尚未輸入網址⋯
💡 產生後，將這組 URL 貼到 SHOPLINE Payments 後台「Webhook 管理 › 新增 Webhook」的 URL 欄位即可完成設定。
- 訂閱事件：建議全部勾選，包含結帳交易（session.created、session.expired、session.pending、session.succeeded）與付款交易（trade.succeeded）
- Sign Key：請留空讓系統自動產生
送出後系統會顯示完整的 Sign Key，點開複製給我們。一個帳號最多可以同時支援 20 個 Webhook，不用擔心「不夠用」的問題。
取得了四個Key之後要怎麼辦？
當您確定上面四個Key都取得後，可以透過前面您使用的工具按一鍵複製貼給我們！還沒使用嗎？沒關係，這邊再給你一次！
SHOPLINE Payments 金鑰回報工具
將 SHOPLINE Payments 後台取得的四組資料填入欄位，一鍵產生訊息並複製傳給客服。
複製後直接貼給客服
請先填入上方四組必填資料⋯
💡 填寫時請直接從 SHOPLINE Payments 後台複製貼上，避免手動輸入造成的空白或字元遺漏。所有資料僅在本機瀏覽器處理，不會上傳。
你可能還想知道…
秒站為什麼要整合 SHOPLINE Payments？
過去要在自己的網站上開通 SHOPLINE Payments，要花時間看開發文件、搞懂 Webhook 設定、處理伺服器驗證。這對一般品牌主、電商經營者、或是剛起步的創業者來說，往往是最痛苦的一段。
秒站這次把這段「技術黑箱」全部收進後台。完成 SHOPLINE Payments 那邊的註冊，拿到四組取號資料，貼回秒站後台，系統就會處理所有驗證與 Webhook 通知，結帳頁就能直接啟用。對使用者來說，好處很直接：
- 不用看開發文件，不用找工程師
- 支援 SHOPLINE Payments 主流付款方式（信用卡、LINE Pay、Apple pay 與 街口支付等，依商家您的方案而定）
- 金流通知由秒站在背景處理，訂單狀態自動同步
- 金鑰、Webhook 統一管理，日後更換一次搞定
對使用者最直接的體感是：開卡、收款、對帳，這條路原本可能要一週，現在一個下午就能收到第一筆訂單的簡訊通知。
秒站串接Shopline Payment對比其他建站方案有什麼優勢？
坊間的建站方案大致可分成三種：自行架設的開源網站（例如 WordPress 加外掛）、大型 SaaS 電商平台、以及秒站這類聚焦於品牌型網站的一站式服務。以 SHOPLINE Payments 串接這件事來看，三種方案的使用者體驗差異會相當明顯：
| 建站方案 | 串接 SHOPLINE Payments 的體驗 | 對非技術使用者的負擔 |
|---|---|---|
| 自行架設開源網站 | 需要自行安裝外掛、寫程式串 API或是用AI MCP | 高，通常需要外包工程師，就算用AI也仍不熟悉 |
| 大型 SaaS 電商平台 | 通常支援，但流程分散在多個設定頁 | 中，操作步驟較多 |
| 秒站 x 即站力 | 四組資料貼上即可啟用 | 低，一次完成不用切換頁面 |
這裡並不是要否定任何一種方案。重點是，如果品牌目的地是「把官網做起來、把流量收進來、把客人留下來」，那花在金流串接的時間應該越短越好。這也是秒站這次更新的初衷：把非核心的技術事務從待辦清單上拿掉，讓品牌主有更多時間把力氣放在商品、文案、流量經營上。
重點整理
還沒有 SHOPLINE Payments 帳號，可以直接用秒站嗎？
可以先完成秒站的建站流程，SHOPLINE Payments 之後再申請。秒站本身支援多種金流，SHOPLINE Payments 是新增的選項之一，不是必要條件。等商家資料到位之後，再補上四組取號資料即可啟用。
Client Key、API Key、Sign Key 貼錯會怎樣？
秒站後台會在驗證階段顯示哪一組有問題。最常見的錯誤是複製時多帶了空白或少複製一個字元，回到 SHOPLINE Payments 後台重新複製貼上即可。金鑰本身不會因為貼錯而失效。
一定要新增 Webhook 嗎？不設定會怎樣？
會。沒有 Webhook 的話，SHOPLINE Payments 完成付款後無法即時通知秒站，訂單狀態會無法自動更新。建議第一次串接時就把 Webhook 設好，結帳交易與付款交易兩個事件群組都勾選。
API Key 可以多開幾組？不小心刪掉怎麼辦？
一個商家帳號最多可以新增 5 組 API Key，不同用途可以各自建立。新增的金鑰可以刪除，刪除後約 24 小時會失效；預設的標準金鑰無法刪除，這是系統保護機制。如果是秒站使用的 API Key 不小心刪掉，重新新增一組並回到秒站後台更新即可。
秒站比自己裝外掛串接好在哪？
差別在「誰負責維護」。自己裝外掛要自行處理版本更新、Webhook 驗證、API 變更，發生問題要自己排查。秒站則是由平台端統一維護金流模組，有變更由秒站同步更新，使用者只要專心在商品、文案、行銷上。
