整合與金鑰
連接分析、Email、LINE、付款、物流與發票服務。
共 5 項操作・12 個步驟・最後複驗 2026-08-14
從哪裡進入
網站後台 → 整合與金鑰
照著下方圖文逐步完成
重點摘要(TL;DR)
總覽顯示各服務的儲存與驗證狀態;秘密金鑰只在對應設定卡保存,不應出現在公開文字、截圖或支援訊息。
什麼時候會用到
- 功能提示缺少第三方服務設定
- 要啟用正式收款或品牌寄信
開始前先準備
- • 準備對應第三方帳號與正確權限
- • 測試資料與正式資料要分開
- • 申請 PAYUNi 時,由店主確認法定聯絡資料、產業類別、交付占比與客單價
操作步驟與完成後的結果
每一項操作都列出從哪裡開始、要做什麼,以及完成後應該看到的結果。
選擇要連接的服務
從總覽辨識狀態,並前往真正的設定位置。
整合金鑰、付款與交付:開店前的安全設定
- 1
這一步要做
從網站後台按「整合與金鑰」,查看每列服務旁的「未設定」、「已設定」、「待驗證」、「已驗證」或「設定錯誤」。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
先從總覽辨識服務目前是未設定、已儲存、待驗證、已驗證或設定錯誤。 - 1核對
- 位置:
- 整合服務頁的 PAYUNi 狀態標籤。
- 動作:
- 確認 PAYUNi 顯示已連接或可驗證。
- 結果:
- 狀態不再是尚未設定,付款與物流功能才能使用。
完成後會看到
可以分辨哪些服務尚未開始、已保存、等待驗證、驗證通過或需要修正。
- 2
這一步要做
在要處理的服務列按「前往設定」。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
按前往設定,進入真正保存 PAYUNi 憑證的商店整合卡。 - 2操作
- 位置:
- PAYUNi 整合卡片右側的「前往設定」按鈕。
- 動作:
- 按「前往設定」。
- 結果:
- 系統會開啟 PAYUNi 金鑰設定頁。
完成後會看到
畫面開啟該服務真正保存設定的功能頁與憑證卡。
注意事項
- • 總覽只列目前已啟用功能會用到的服務。
取得並保存必要憑證
依卡片引導取得同一帳號與環境的憑證,並安全保存。
- 3
這一步要做
在憑證卡展開「如何取得這些資料?逐步引導」,照卡片列出的第三方後台位置準備每個欄位。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
展開逐步引導,再依第三方後台的位置準備資料。 - 3操作
- 位置:
- PAYUNi 整合卡片顯示「尚未設定」的狀態。
- 動作:
- 進入 PAYUNi 設定流程。
- 結果:
- 設定完成後,狀態會改為已連接或可驗證。
完成後會看到
取得與欄位名稱相符,而且屬於同一個帳號與環境的 ID、Key、Secret、Email 或其他設定值。
- 4
這一步要做
申請 PAYUNi 時,先複製網站名稱、網址與營運說明,再由店主依實況填寫聯絡資料、產業、交付占比、履約保證與平均客單價。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
網站資料可複製;法定聯絡與營運資料仍須店主依實況填寫。 - 4核對
- 位置:
- PAYUNi 整合卡片右側的申請連結。
- 動作:
- 需要商店帳號時按「開啟 PAYUNi 申請頁」。
- 結果:
- 系統會在新分頁開啟 PAYUNi 官方申請頁。
完成後會看到
申請內容和實際營運一致,而且只申請網站目前支援的付款工具。
- 5
這一步要做
把值貼到同名欄位,移除前後空白後按「儲存」。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
三個憑證欄位必須屬於同一個 PAYUNi 商店。 - 5核對
- 位置:
- PAYUNi 設定頁的 MerID、Hash Key 與 Hash IV 欄位。
- 動作:
- 逐欄貼上商店自己的 PAYUNi 正式金鑰。
- 結果:
- 三個欄位都有值,且沒有前後空白。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
本教學只指出儲存邊界,不輸入或送出任何秘密。 - 5核對
- 位置:
- PAYUNi 金鑰設定頁右上角的「儲存」。
- 動作:
- 確認三個欄位後按「儲存」。
- 結果:
- 金鑰會保存,接著可以執行連線驗證。
完成後會看到
畫面顯示已儲存;秘密欄位重新整理後只顯示遮罩或已儲存標記。
注意事項
- • 秘密欄位留空代表保留原值;只有勾「清除此金鑰」才會刪除。不要把秘密值放進公開文字、截圖或客服訊息。
執行支援的連線驗證
把已保存與第三方服務實際接受的設定分開判斷。
- 6
這一步要做
服務卡若有「驗證設定」,請在儲存後按一次。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
已儲存不等於已驗證;只有支援即時驗證的服務才有這個按鈕。 - 6核對
- 位置:
- 整合設定頁下方的「驗證設定」按鈕。
- 動作:
- 按「驗證設定」。
- 結果:
- 畫面會回報連線驗證結果。
完成後會看到
按鈕顯示「驗證中…」,完成後出現通過、警告或可修正的錯誤。
- 7
這一步要做
若驗證失敗,依錯誤訊息核對帳號、環境、權限、網域、Key 或 Secret;修正並儲存後,再按一次「驗證設定」。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
已儲存不等於已驗證;只有支援即時驗證的服務才有這個按鈕。 - 7核對
- 位置:
- 整合設定頁下方的「驗證設定」按鈕。
- 動作:
- 按「驗證設定」。
- 結果:
- 畫面會回報連線驗證結果。
完成後會看到
設定正確時顯示已驗證;只有建議事項時顯示警告,不會假裝完全通過。
注意事項
- • 不是每一種服務都有即時驗證。PAYUNi 沒有這個按鈕,不能把已儲存描述成已驗證。
完成第三方後台仍需要的設定
把平台提供的回呼網址、webhook 或 DNS 值正確交給第三方服務。
- 8
這一步要做
若卡片要求回呼網址、webhook 或 DNS,從逐步引導找到要複製的值與第三方後台入口。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
展開逐步引導,再依第三方後台的位置準備資料。 - 8操作
- 位置:
- PAYUNi 整合卡片顯示「尚未設定」的狀態。
- 動作:
- 進入 PAYUNi 設定流程。
- 結果:
- 設定完成後,狀態會改為已連接或可驗證。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
用複製按鈕取得完整網址,收到第一筆貨態才證明接通。 - 8核對
- 位置:
- PAYUNi 物流設定頁顯示的貨態 Notify URL。
- 動作:
- 複製這個網址到 PAYUNi 後台的 Notify URL 欄位。
- 結果:
- PAYUNi 能把最新貨態回傳到訂單。
完成後會看到
畫面提供服務專用的值、複製按鈕或外部後台連結。
- 9
這一步要做
把值貼到第三方後台指定欄位並儲存;DNS 記錄要逐筆核對類型、主機與值。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
用複製按鈕取得完整網址,收到第一筆貨態才證明接通。 - 9核對
- 位置:
- PAYUNi 物流設定頁顯示的貨態 Notify URL。
- 動作:
- 複製這個網址到 PAYUNi 後台的 Notify URL 欄位。
- 結果:
- PAYUNi 能把最新貨態回傳到訂單。
完成後會看到
第三方服務接受並保存這個網站的回呼、webhook 或 DNS 設定。
- 10
這一步要做
回安庭重新驗證或查看狀態;PAYUNi 物流則要等第一筆貨態回來。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
第一與第三步由系統判斷;物流申請與貼網址須由店主確認。 - 10核對
- 位置:
- PAYUNi 物流設定頁的 7-ELEVEN 店到店開通進度。
- 動作:
- 依進度完成申請、審核與啟用。
- 結果:
- 狀態會顯示目前開通階段與下一步。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
先從總覽辨識服務目前是未設定、已儲存、待驗證、已驗證或設定錯誤。 - 10核對
- 位置:
- 整合服務頁的 PAYUNi 狀態標籤。
- 動作:
- 確認 PAYUNi 顯示已連接或可驗證。
- 結果:
- 狀態不再是尚未設定,付款與物流功能才能使用。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
已儲存不等於已驗證;只有支援即時驗證的服務才有這個按鈕。 - 10核對
- 位置:
- 整合設定頁下方的「驗證設定」按鈕。
- 動作:
- 按「驗證設定」。
- 結果:
- 畫面會回報連線驗證結果。
完成後會看到
可驗證的服務更新狀態;PAYUNi 開通進度的第三步收到貨態後顯示已接通。
注意事項
- • PAYUNi checklist 只有第一步金鑰與第三步貨態可由系統判斷;第二步物流申請與貼網址必須由店主人工確認。
用安全測試確認資料真的往返
用不扣款、自己的測試資料,確認平台與第三方服務都留下同一筆結果。
- 11
這一步要做
依服務執行安全測試,例如送出自己的測試表單、走沙盒結帳,或從自己的 LINE 帳號傳一則測試訊息。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
核對測試或正式模式,並使用店家自己所屬環境的憑證。 - 11核對
- 位置:
- 付款與發票頁的「付款模式」設定。
- 動作:
- 依目前用途選擇測試或正式環境。
- 結果:
- 測試期間不會誤送正式交易;上線前可明確切換正式環境。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
設定齊全後,下一步是走一筆明確不扣款的完整測試單。 - 11核對
- 位置:
- 公開商品頁的「加入購物車」按鈕。
- 動作:
- 從訪客端實際按一次加入購物車。
- 結果:
- 商品會進入購物車,證明銷售模式與商品狀態都正確。
完成後會看到
第三方服務與安庭後台都留下時間與內容相符的測試結果。
- 12
這一步要做
回到對應功能頁查看收件箱、訂單、寄送紀錄或訊息中心,核對剛才的測試資料。

手機可左右滑動畫面,看清楚紅圈與欄位文字。
設定齊全後,下一步是走一筆明確不扣款的完整測試單。 - 12核對
- 位置:
- 公開商品頁的「加入購物車」按鈕。
- 動作:
- 從訪客端實際按一次加入購物車。
- 結果:
- 商品會進入購物車,證明銷售模式與商品狀態都正確。
完成後會看到
後台找到同一筆測試資料,證明服務不是只有已設定,而是真的有資料往返。
注意事項
- • 金流測試只用沙盒或明確不扣款的方式;不要為了測試刷正式客戶款項。
遇到問題先看這裡
- 金鑰看起來正確,驗證卻失敗?
- 確認金鑰屬於正確帳號與環境,權限足夠且沒有多餘空白;不要把測試金鑰當正式金鑰,也不要把金鑰貼到客服公開訊息。
- PAYUNi 商店申請要填哪些資料?
- PAYUNi 設定卡會整理可複製的商店名稱、網址與營運說明,並直達新增商店頁;聯絡資料、產業類別、交付占比、履約保證與平均客單價仍要由店主依實際營運填寫。平台目前支援信用卡一次付清、ATM 與超商代碼。
- PAYUNi 物流申請表的「貨態 Notify URL」要填什麼?
- 填你這個網站專屬的一行網址,PAYUNi 收送貨進度時會通知到那裡。兩個地方都拿得到、內容一樣:整合服務頁的 PAYUNi 金鑰卡,或商店設定的「配送與取貨 → 超商取貨 → 出單方式選 PAYUNi」開通進度卡,都有一鍵複製。請用複製的不要手打,少一個字元的症狀是貨態永遠不會來且沒有任何錯誤訊息。這一欄是商店層級設定一次,與收款金鑰共用同一個 PAYUNi 商店,不必另外申請物流金鑰;還沒在平台開啟超商取貨也可以先貼、先送件。
- 包裹已經寄出,訂單卻一直沒有貨態?
- 先看出單方式:自行開單(賣貨便等)本來就沒有貨態回報,賣家平台沒有提供介接。走 PAYUNi 或綠界物流卻沒貨態,最常見的是貨態網址沒貼或貼錯一個字元——到「配送與取貨」看開通進度卡,超過兩天沒有任何回報時它會直接指出這一點,回 PAYUNi 後台的物流申請頁重貼即可。
逐步操作
