整合與金鑰
連接分析、Email、LINE、付款、物流與發票服務。
共 5 項操作・17 個步驟・最後複驗 2026-08-14
從哪裡進入
網站後台 → 整合與金鑰
照著下方圖文逐步完成
重點摘要（TL;DR）
總覽顯示各服務的儲存與驗證狀態；秘密金鑰只在對應設定卡保存，不應出現在公開文字、截圖或支援訊息。
什麼時候會用到
- 功能提示缺少第三方服務設定
- 要啟用正式收款或品牌寄信
開始前先準備
- • 準備對應第三方帳號與正確權限
- • 測試資料與正式資料要分開
- • 申請 PAYUNi 時，由店主確認法定聯絡資料、產業類別、交付占比與客單價
操作步驟與完成後的結果
每一項操作都列出從哪裡開始、要做什麼，以及完成後應該看到的結果。
選擇要連接的服務
從總覽辨識狀態，並前往真正的設定位置。
- 1
這一步要做
從網站後台按「整合與金鑰」，查看每列服務旁的「未設定」、「已設定」、「待驗證」、「已驗證」或「設定錯誤」。
為什麼：總覽讓你一眼看出哪組金鑰還沒填、哪組驗證失敗，不必一頁一頁點進功能設定找。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
先從總覽辨識服務目前是未設定、已儲存、待驗證、已驗證或設定錯誤。 - 1核對
- 位置：
- 整合服務頁的 PAYUNi 狀態標籤。
- 動作：
- 確認 PAYUNi 顯示已連接或可驗證。
- 結果：
- 狀態不再是尚未設定，付款與物流功能才能使用。
完成後會看到
可以分辨哪些服務尚未開始、已保存、等待驗證、驗證通過或需要修正。
- 2
這一步要做
在要處理的服務列按「前往設定」。
為什麼：金鑰跟著功能走：真正的填寫欄位在各功能自己的設定頁，例如收款金鑰在商品設定、寄信金鑰在 Email 寄送。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
按前往設定，進入真正保存 PAYUNi 憑證的商店整合卡。 - 2操作
- 位置：
- PAYUNi 整合卡片右側的「前往設定」按鈕。
- 動作：
- 按「前往設定」。
- 結果：
- 系統會開啟 PAYUNi 金鑰設定頁。
完成後會看到
畫面開啟該服務真正保存設定的功能頁與憑證卡。
- 3
這一步要做
要找的服務不在清單上時，先到側欄「探索更多功能」開啟會用到它的功能，再回「整合與金鑰」查看。
為什麼：這頁只列已啟用功能會用到的服務：Email 寄送要開表單，LINE 要開 LINE，綠界與 PAYUNi 金流要開商店或預約，物流、發票與 LINE Pay 要開商店；網站分析與追蹤碼則一律都有。
完成後會看到
功能開啟後，對應的服務會自動出現在清單上。
注意事項
- • 總覽只列目前已啟用功能會用到的服務。
取得並保存必要憑證
依卡片引導取得同一帳號與環境的憑證，並安全保存。
- 4
這一步要做
在憑證卡展開「如何取得這些資料？逐步引導」，照卡片列出的第三方後台位置準備每個欄位。
為什麼：照引導一步步拿，最常見的錯誤（拿到測試環境的值、拿到別的帳號的值）就不容易發生。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
展開逐步引導，再依第三方後台的位置準備資料。 - 4操作
- 位置：
- PAYUNi 整合卡片顯示「尚未設定」的狀態。
- 動作：
- 進入 PAYUNi 設定流程。
- 結果：
- 設定完成後，狀態會改為已連接或可驗證。
完成後會看到
取得與欄位名稱相符，而且屬於同一個帳號與環境的 ID、Key、Secret、Email 或其他設定值。
- 5
這一步要做
申請 PAYUNi 時，先複製網站名稱、網址與營運說明，再由店主依實況填寫聯絡資料、產業、交付占比、履約保證與平均客單價。
為什麼：申請資料由金流公司審核，內容要和你實際的生意一致；平台能幫你準備的只有網站名稱、網址與營運說明。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
網站資料可複製；法定聯絡與營運資料仍須店主依實況填寫。 - 5核對
- 位置：
- PAYUNi 整合卡片右側的申請連結。
- 動作：
- 需要商店帳號時按「開啟 PAYUNi 申請頁」。
- 結果：
- 系統會在新分頁開啟 PAYUNi 官方申請頁。
完成後會看到
申請內容和實際營運一致，而且只申請網站目前支援的付款工具。
- 6
這一步要做
把值貼到同名欄位，移除前後空白後按「儲存」。
為什麼：每一格都要放對應的值，平台才能代表你的帳號跟第三方服務溝通。
欄位怎麼填
- Merchant ID（商店代號）
- 綠界廠商後台「系統設定 → 系統介接設定」最上方的商店代號，純數字。
- Hash Key
- 綠界廠商後台「系統設定 → 系統介接設定」的表格一列一個服務：收款用「金流、MPOS」那一列，物流、發票各有自己那一列，不能混用。
- Hash IV
- 跟 Hash Key 在同一個位置，一起複製。
- MerID（商店代號）
- PAYUNi 商店後台 → 串接資訊 → 商店代號 MerID。
- Hash Key（32 字元）
- PAYUNi 的串接 Hash Key，必須剛好 32 個半形字元。
- Hash IV（16 字元）
- PAYUNi 的串接 Hash IV，必須剛好 16 個半形字元。
- Resend API Key
- 在 resend.com 的 API Keys 建立，權限選 Full access；建立當下就要複製，之後看不到完整金鑰。
- 寄件人 Email
- 必須是你在 Resend 驗證過的網域底下的信箱；gmail、yahoo 等公共信箱不能當寄件人。
- GA4 評估 ID
- G- 開頭，在 Google Analytics →「管理」→ 資料串流裡找。
- Channel Secret
- LINE Developers 的「Basic settings」分頁；LINE Login 與 Messaging API 各有一組，不一樣。
- 清除此金鑰
- 已儲存的秘密欄位下方才有這個勾選框；勾選後再儲存，才會刪掉那組金鑰。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
三個憑證欄位必須屬於同一個 PAYUNi 商店。 - 6核對
- 位置：
- PAYUNi 設定頁的 MerID、Hash Key 與 Hash IV 欄位。
- 動作：
- 逐欄貼上商店自己的 PAYUNi 正式金鑰。
- 結果：
- 三個欄位都有值，且沒有前後空白。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
本教學只指出儲存邊界，不輸入或送出任何秘密。 - 6核對
- 位置：
- PAYUNi 金鑰設定頁右上角的「儲存」。
- 動作：
- 確認三個欄位後按「儲存」。
- 結果：
- 金鑰會保存，接著可以執行連線驗證。
完成後會看到
畫面顯示已儲存；秘密欄位重新整理後只顯示遮罩或已儲存標記。
做錯或略過會怎樣
看得到內容的欄位（例如商店代號、寄件人 Email、GA4 評估 ID）清空再儲存，就等於刪除；只有秘密欄位留空才是保留原值。
- 7
這一步要做
看儲存後出現的訊息：成功時會說已儲存（PAYUNi 會提醒下一步先用測試環境完成一筆結帳），格式不對時會指出是哪一格。
為什麼：格式不對的值不會被存進去，看了訊息才知道這次到底有沒有存成功。
完成後會看到
訊息是「已儲存。」，或指出要修正的欄位，例如「Hash Key 必須是 32 個半形字元，請從 PAYUNi 後台重新複製。」
注意事項
- • 秘密欄位留空代表保留原值；只有勾「清除此金鑰」才會刪除。不要把秘密值放進公開文字、截圖或客服訊息。
- • 只有網站擁有者能儲存金鑰；共同管理者可以開這頁查看狀態，按儲存會被拒絕。
執行支援的連線驗證
把已保存與第三方服務實際接受的設定分開判斷。
- 8
這一步要做
服務卡若有「驗證設定」，請在儲存後按一次。
為什麼：儲存只代表平台收到了值；驗證才會實際去問第三方服務接不接受。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
已儲存不等於已驗證；只有支援即時驗證的服務才有這個按鈕。 - 8核對
- 位置：
- 整合設定頁下方的「驗證設定」按鈕。
- 動作：
- 按「驗證設定」。
- 結果：
- 畫面會回報連線驗證結果。
完成後會看到
按鈕顯示「驗證中…」，完成後出現通過、警告或可修正的錯誤。
- 9
這一步要做
若驗證失敗，依錯誤訊息核對帳號、環境、權限、網域、Key 或 Secret；修正並儲存後，再按一次「驗證設定」。
為什麼：錯誤訊息通常會指出是哪個環節出錯，照著修比整組重貼快。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
已儲存不等於已驗證；只有支援即時驗證的服務才有這個按鈕。 - 9核對
- 位置：
- 整合設定頁下方的「驗證設定」按鈕。
- 動作：
- 按「驗證設定」。
- 結果：
- 畫面會回報連線驗證結果。
完成後會看到
設定正確時顯示已驗證；只有建議事項時顯示警告，不會假裝完全通過。
做錯或略過會怎樣
同一組值反覆重按驗證，結果不會改變；先依訊息回第三方後台確認帳號、環境或網域，再重新儲存。
- 10
這一步要做
綠界金流驗證通過後，卡片下方會出現「驗證通過了 — 接下來」，照列出的項目逐一完成，例如「切換為正式收款」、「開放線上付款（信用卡）」。
為什麼：金鑰驗證通過不等於客人付得了錢，正式收款與付款方式還要另外打開。
完成後會看到
還差的項目都完成後，清單只剩「跑一筆 100 元真實測試」與「上架你的商品」。
注意事項
- • 不是每一種服務都有即時驗證：有「驗證設定」的是 Email 寄送（Resend）、ECPay 綠界金流、LINE Login 與 LINE Messaging API；PAYUNi 等其他服務沒有這個按鈕，不能把已儲存描述成已驗證。
完成第三方後台仍需要的設定
把平台提供的回呼網址、webhook 或 DNS 值正確交給第三方服務。
- 11
這一步要做
若卡片要求回呼網址、webhook 或 DNS，從逐步引導找到要複製的值與第三方後台入口。
為什麼：這些值是第三方服務回頭通知你網站的地址，平台沒辦法替你貼進對方後台。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
展開逐步引導，再依第三方後台的位置準備資料。 - 11操作
- 位置：
- PAYUNi 整合卡片顯示「尚未設定」的狀態。
- 動作：
- 進入 PAYUNi 設定流程。
- 結果：
- 設定完成後，狀態會改為已連接或可驗證。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
用複製按鈕取得完整網址，收到第一筆貨態才證明接通。 - 11核對
- 位置：
- PAYUNi 物流設定頁顯示的貨態 Notify URL。
- 動作：
- 複製這個網址到 PAYUNi 後台的 Notify URL 欄位。
- 結果：
- PAYUNi 能把最新貨態回傳到訂單。
完成後會看到
畫面提供服務專用的值、複製按鈕或外部後台連結。
- 12
這一步要做
把值貼到第三方後台指定欄位並儲存；DNS 記錄要逐筆核對類型、主機與值。
為什麼：對方後台存的值要和平台給的一字不差，通知才送得回來。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
用複製按鈕取得完整網址，收到第一筆貨態才證明接通。 - 12核對
- 位置：
- PAYUNi 物流設定頁顯示的貨態 Notify URL。
- 動作：
- 複製這個網址到 PAYUNi 後台的 Notify URL 欄位。
- 結果：
- PAYUNi 能把最新貨態回傳到訂單。
完成後會看到
第三方服務接受並保存這個網站的回呼、webhook 或 DNS 設定。
做錯或略過會怎樣
用卡片上的複製按鈕，不要手打；少一個字元時通知會靜靜送不到，而且不會有任何錯誤訊息。
- 13
這一步要做
回安庭重新驗證或查看狀態；PAYUNi 物流則要等第一筆貨態回來。
為什麼：PAYUNi 物流沒有即時驗證，只有真的收到一筆貨態，才能證明網址貼對了。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
第一與第三步由系統判斷；物流申請與貼網址須由店主確認。 - 13核對
- 位置：
- PAYUNi 物流設定頁的 7-ELEVEN 店到店開通進度。
- 動作：
- 依進度完成申請、審核與啟用。
- 結果：
- 狀態會顯示目前開通階段與下一步。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
先從總覽辨識服務目前是未設定、已儲存、待驗證、已驗證或設定錯誤。 - 13核對
- 位置：
- 整合服務頁的 PAYUNi 狀態標籤。
- 動作：
- 確認 PAYUNi 顯示已連接或可驗證。
- 結果：
- 狀態不再是尚未設定，付款與物流功能才能使用。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
已儲存不等於已驗證；只有支援即時驗證的服務才有這個按鈕。 - 13核對
- 位置：
- 整合設定頁下方的「驗證設定」按鈕。
- 動作：
- 按「驗證設定」。
- 結果：
- 畫面會回報連線驗證結果。
完成後會看到
可驗證的服務更新狀態；PAYUNi 開通進度的第三步收到貨態後顯示已接通。
- 14
這一步要做
卡片引導裡的開關類步驟，也要在第三方後台完成：LINE Login 要把 channel 從「Developing（開發中）」切成「Published（已公開）」；LINE Messaging API 要打開「Use webhook」。
為什麼：這些開關在第三方後台裡，平台看不到；漏開時你自己測試一切正常，客人卻會失敗。
完成後會看到
客人都能用 LINE 登入，官方帳號收到的訊息也會送進網站後台。
做錯或略過會怎樣
LINE 官方帳號的 Webhook 網址在存檔後會由平台自動登記，不用手貼；只差「Use webhook」沒開時，訊息一樣進不來。
注意事項
- • PAYUNi checklist 只有第一步金鑰與第三步貨態可由系統判斷；第二步物流申請與貼網址必須由店主人工確認。
用安全測試確認資料真的往返
用不扣款、自己的測試資料，確認平台與第三方服務都留下同一筆結果。
- 15
這一步要做
依服務執行安全測試，例如送出自己的測試表單、走沙盒結帳，或從自己的 LINE 帳號傳一則測試訊息。
為什麼：兩邊都有同一筆才算真的接通；只看到「已設定」，金鑰貼錯了也看不出來。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
核對測試或正式模式，並使用店家自己所屬環境的憑證。 - 15核對
- 位置：
- 付款與發票頁的「付款模式」設定。
- 動作：
- 依目前用途選擇測試或正式環境。
- 結果：
- 測試期間不會誤送正式交易；上線前可明確切換正式環境。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
設定齊全後，下一步是走一筆明確不扣款的完整測試單。 - 15核對
- 位置：
- 公開商品頁的「加入購物車」按鈕。
- 動作：
- 從訪客端實際按一次加入購物車。
- 結果：
- 商品會進入購物車，證明銷售模式與商品狀態都正確。
完成後會看到
第三方服務與安庭後台都留下時間與內容相符的測試結果。
- 16
這一步要做
回到對應功能頁查看收件箱、訂單、寄送紀錄或訊息中心，核對剛才的測試資料。
為什麼：後台找得到那一筆，代表之後客人的資料也會照同一條路進來。
手機可左右滑動畫面，看清楚紅圈與欄位文字。
設定齊全後，下一步是走一筆明確不扣款的完整測試單。 - 16核對
- 位置：
- 公開商品頁的「加入購物車」按鈕。
- 動作：
- 從訪客端實際按一次加入購物車。
- 結果：
- 商品會進入購物車，證明銷售模式與商品狀態都正確。
完成後會看到
後台找到同一筆測試資料，證明服務不是只有已設定，而是真的有資料往返。
- 17
這一步要做
回「整合與金鑰」總覽，確認測過的服務狀態是「已驗證」或「已設定」，沒有「設定錯誤」。
為什麼：測完留一個正常的基準，之後哪一組出問題，回這頁就看得出來。
完成後會看到
每個要用的服務都不是「未設定」或「設定錯誤」。
注意事項
- • 金流請用測試環境試走，或照綠界卡片的「跑一筆 100 元真實測試」用自己的卡刷小額、測完原路退刷；不要拿客人的正式訂單測試。
遇到問題先看這裡
- 金鑰看起來正確，驗證卻失敗？
- 確認金鑰屬於正確帳號與環境，權限足夠且沒有多餘空白；不要把測試金鑰當正式金鑰，也不要把金鑰貼到客服公開訊息。
- PAYUNi 商店申請要填哪些資料？
- PAYUNi 設定卡會整理可複製的商店名稱、網址與營運說明，並直達新增商店頁；聯絡資料、產業類別、交付占比、履約保證與平均客單價仍要由店主依實際營運填寫。平台目前支援信用卡一次付清、ATM 與超商代碼。
- PAYUNi 物流申請表的「貨態 Notify URL」要填什麼？
- 填你這個網站專屬的一行網址，PAYUNi 收送貨進度時會通知到那裡。兩個地方都拿得到、內容一樣：整合服務頁的 PAYUNi 金鑰卡，或商店設定的「配送與取貨 → 超商取貨 → 出單方式選 PAYUNi」開通進度卡，都有一鍵複製。請用複製的不要手打，少一個字元的症狀是貨態永遠不會來且沒有任何錯誤訊息。這一欄是商店層級設定一次，與收款金鑰共用同一個 PAYUNi 商店，不必另外申請物流金鑰；還沒在平台開啟超商取貨也可以先貼、先送件。
- 包裹已經寄出，訂單卻一直沒有貨態？
- 先看出單方式：自行開單（賣貨便等）本來就沒有貨態回報，賣家平台沒有提供介接。走 PAYUNi 或綠界物流卻沒貨態，最常見的是貨態網址沒貼或貼錯一個字元——到「配送與取貨」看開通進度卡，超過兩天沒有任何回報時它會直接指出這一點，回 PAYUNi 後台的物流申請頁重貼即可。
- 為什麼「整合與金鑰」看不到 LINE 或金流？
- 這頁只列已啟用功能會用到的服務。Email 寄送要開表單，LINE 要開 LINE，綠界與 PAYUNi 金流要開商店或預約，物流、發票與 LINE Pay 要開商店。到側欄「探索更多功能」開啟後，就會自動出現。
- 共同管理者可以幫我填金鑰嗎？
- 不行。金鑰只有網站擁有者能儲存，共同管理者可以開頁面看狀態，按儲存會被拒絕；內容編輯則看不到這一頁。請擁有者本人登入填寫。
- 秘密欄位只顯示一串遮罩，看不到原本的值？
- 這是刻意的：秘密金鑰存好後不會再顯示原文，欄位旁會標「已儲存」。要換就直接貼新的值再儲存；不改就留空，留空會保留原本的金鑰；要刪除才勾「清除此金鑰」。
- 儲存時出現「格式不正確」？
- 平台會先檢查格式，格式不對的值不會存進去。常見原因是多複製了空白或少了字元：PAYUNi 的 Hash Key 要剛好 32 個半形字元、Hash IV 要 16 個，GA4 評估 ID 要 G- 開頭。請回第三方後台重新複製。
- LINE Login 我自己測試可以登入，客人卻失敗？
- 最常見的原因是 channel 還在「Developing（開發中）」：這時只有 channel 管理員能登入，客人手機上常顯示「無法正常執行」。到 LINE Developers 點頁面頂端的「Developing」，切換成「Published（已公開）」即可。
- LINE 官方帳號的 Webhook 網址要貼到哪裡？
- 不用自己貼。LINE Messaging API 的金鑰存檔後，平台會自動把這個網站專屬的 Webhook 網址登記到你的 channel；你只要到 LINE Console「Messaging API」分頁打開「Use webhook」，接線狀態會顯示在 LINE 設定頁。
- LINE 的設定卡只顯示「查看方案並啟用席位」？
- LINE 這類真實社群帳號的連接需要有效的付費席位；免費方案仍可以繼續編輯與預覽網站。按「查看方案並啟用席位」購買後，再回來填寫金鑰。
逐步操作