「我們想做桌邊 QR 點餐，付款用 LINE Pay。怎麼開始？」

幾乎每個做台灣餐飲 POS 或 B2C 電商的客戶都會問。LINE Pay 在台灣使用率僅次於信用卡，現場 + 線上通吃，是 must-have 的支付通路。

但 LINE Pay 商家 API 不像信用卡金流（藍新 / 綠界）填個表 3 天就能用 — 它要走真人審核、要交實體店面照片、有兩段審核加起來 2-3 週。我們幫幾個餐飲客戶申請過，這篇整理 5 個「官方文件沒寫但會卡你」的眉角。

先理解 LINE Pay 3 個不同的「商家方案」 #

很多人卡在第一步是因為搞不清楚 LINE Pay 給商家的不是只有一個服務：

方案	用途	開發者要做什麼	費率
LINE Pay Mini	在 LINE 官方帳號裡開店，付款用 LINE Pay	不用碰 API，後台填一填	~3.0%
Online API（網路商店）	自己的網站 / App 嵌入「LINE Pay 結帳」按鈕，導頁付款	串 v3 Request / Confirm API	~2.8-3.0%
Offline API（實體店面）	POS / 收銀機掃顧客手機的 LINE Pay 條碼收款	串 v2 oneTimePay API	~2.8-3.0%

第一個眉角：很多人以為「申請了 LINE Pay Mini = 可以串 API」 — 錯。Mini 是封閉系統，完全不開放 API。要寫 code 整合到你自己的 POS / 網站，要另外申請 Online API + Offline API。

如果你做的是「桌邊 QR 點餐」這種混合場景：

客人手機掃 QR → 在自己網站付款 = Online API
客人到櫃檯結帳，員工掃他手機 LINE Pay 條碼 = Offline API

兩個都要 — 申請時兩個都勾。

眉角 1：先申請沙箱 — 馬上可用，不用等 #

正式商戶審核要 2-3 週，但沙箱當天就能下載 Channel ID/Secret。

申請網址：https://developers-pay.line.me/sandbox

沙箱 endpoint：https://sandbox-api-pay.line.me

先用沙箱把整套流程刻完：

// Online API v3 - Request
POST https://sandbox-api-pay.line.me/v3/payments/request

Headers:
  Content-Type: application/json
  X-LINE-ChannelId: <sandbox channel id>
  X-LINE-Authorization-Nonce: <UUID>
  X-LINE-Authorization: <HMAC-SHA256 簽章>

Body:
  {
    "amount": 100,
    "currency": "TWD",
    "orderId": "TEST-001",
    "packages": [...],
    "redirectUrls": {
      "confirmUrl": "https://yourdomain/linepay/confirm",
      "cancelUrl": "https://yourdomain/linepay/cancel"
    }
  }

沙箱期間做完：

HMAC-SHA256 簽章邏輯（這條最容易踩坑，body 要 stringify 完才算，多一個空格都會 401）
redirect / cancel callback
訂單狀態機（pending → paid / failed / refunded）
退款 API 串接

正式 Channel 拿到後改 base URL + Channel ID/Secret 就上線，比邊串邊等審核安全 10 倍。

眉角 2：營業型態「實體 + 線上」一定都勾 #

正式商戶申請網址：https://pay.line.me/portal/tw/business/main

填表時會問「營業型態」— 有兩個 checkbox：

☐ 實體商店（Offline）
☐ 線上（Online）

只勾一個 = 之後想加另一個要重審一次（再 2-3 週）。

我們的建議：兩個都勾。

理由：

你只勾	之後你做不了
只勾線上	桌邊掃客人 LINE Pay 條碼（員工拿掃描槍那種）
只勾實體	客人手機自己付款的 redirect 流程

即使現在用不到第二種，勾起來不額外收費、不影響審核時間。

選「真人服務」選項 — LINE Pay 業務會主動聯絡你補件，比自己摸索快。

眉角 3：IP 白名單必設 — 漏設 API 全部 403 #

審核過了、拿到 Channel ID/Secret，但 API call 一直回 403？

99% 是這個：LINE Pay 商家後台有 IP 白名單。

設定位置：Merchant Center → 開發者工具 → 管理付款伺服器 IP

把你的對外固定 IP 加進去。要注意：

是 server 出口 IP，不是 client 的 IP
用浮動 IP 的話會週期性 403 — 拜託業主辦固定 IP（中華電信加購大約月 NT$300）
Cloud server（GCP / AWS）要用 NAT Gateway 出口 IP，不是 VM 內部 IP
多開幾個 instance 做 load balance → 每個 instance 的出口 IP 都要登錄

我們有客戶因為這個被卡了一整週「為什麼上線後 LINE Pay 都不能用」— 最後發現是負載均衡器後面新加了一台 server，沒登錄。

眉角 4：拿 Channel ID/Secret 有個隱藏步驟 — Email 驗證碼 #

審核通過信寫得很乾，沒寫怎麼拿 Channel ID/Secret。實際步驟：

登入 Merchant Center：https://pay.line.me/portal/tw/auth/login
左側選單 → 管理付款連結 → 管理連結金鑰
點「查詢」按鈕
Email 收驗證碼（10 分鐘內有效，過期要重發）
在頁面輸入驗證碼
這時候才會顯示 Channel ID 跟 Channel Secret

Channel Secret 只能看一次。當下截圖、存密碼管理工具、或抄到開發環境變數 — 別關頁面才發現沒抄。

漏掉重來：再點查詢、再收驗證碼。但每次 reveal 都會 log，業主有疑慮的話會問。

眉角 5：必備 7 份文件清單（公司戶） #

LINE Pay 業務會請你寄這 7 份到指定 email：

#	文件	哪裡取得
1	公司登記 / 商業登記證明	經濟部商業司網站下載
2	統一發票 / 統編證明書	國稅局領取
3	稅籍登記證明	國稅局線上下載（電子檔即可）
4	負責人身分證正反面	自拍
5	金融機構存摺封面影本	戶名要跟公司名一致 ← 最常踩坑
6	店面招牌外觀照 + 店內照 + 菜單照	自己拍
7	店家對外固定 IP	跟電信業者確認

第 5 項最常重來：負責人個人帳戶不行、合作社帳戶不行、人頭帳戶不行 — 戶名必須是公司全名（跟公司登記證明對得起來）。

公司戶 vs 個人戶差別：

個人戶：月收款上限約 NT$50,000（過了會卡撥款）
公司戶：無限制（推薦）

如果你的客戶還沒設公司 — 先把支付這條讓出去用其他方式（信用卡 / 街口 / Apple Pay 之類），等公司登記下來再來申請 LINE Pay。

審核時程實測 #

階段	審核方	我們實測時間
第一段：LINE Pay 內部審核	LINE Pay Taiwan	5-7 個工作天
第二段：一卡通票證股份	一卡通（金流牌照方）	5-15 個工作天
合計		2-3 週

中間補件會延長。最常被退的：店面照沒拍到完整招牌、菜單沒拍清楚價格、存摺戶名對不起來。第一次就拍清楚，省 1 週。

撥款週期：T+5 #

審核過後上線開始收款，LINE Pay 撥款是 T+5 個工作天（交易日起算第 5 個工作天匯入綁定的銀行帳戶）。

對現金流敏感的小餐廳：每天現金交易進帳袋、LINE Pay 進帳要等 5 天 — 記得跟業主說明，免得他第一週看不到錢來問你 bug。

重點整理 #

#	眉角	為什麼會卡
1	先申請沙箱平行 hack	正式審核 2-3 週，沙箱當天可用
2	營業型態實體 + 線上都勾	漏勾 = 之後加要再審 2-3 週
3	IP 白名單一定要登錄	漏設 = 上線 API 全 403
4	Channel Secret 拿到當下就抄	只能看一次（要再驗證碼）
5	7 份文件第 1 次就備齊	缺一份退件 → 延 1 週

客戶想評估 #

我們幫餐飲業者做過完整的桌邊 QR + LINE Pay + 電子發票整合，從申請 → 串接 → 上線一條龍經驗。

可以聊聊：

代辦申請 — 你只負責拍照、簽授權書，文件來回我們處理
POS 整合 — 串到你現有的 POS / ERP / 自架網站
完整 POS 方案 — Electron 桌面 POS + LINE Pay + 電子發票 + 桌邊 QR

聯絡：0912852835 / henryccy@icloud.com / LINE @3q3tw / 線上表單

想做 POS 串 LINE Pay？商家 API 申請的 5 個眉角