搜尋操作說明
帳號、權限與網站設定展開目錄
帳號、權限與網站設定目前可使用

整合與金鑰

連接分析、Email、LINE、付款、物流與發票服務。

5 項操作・12 個步驟・最後複驗 2026-08-14

從哪裡進入

網站後台 → 整合與金鑰

照著下方圖文逐步完成

重點摘要(TL;DR)

總覽顯示各服務的儲存與驗證狀態;秘密金鑰只在對應設定卡保存,不應出現在公開文字、截圖或支援訊息。

什麼時候會用到

  • 功能提示缺少第三方服務設定
  • 要啟用正式收款或品牌寄信

開始前先準備

  • 準備對應第三方帳號與正確權限
  • 測試資料與正式資料要分開
  • 申請 PAYUNi 時,由店主確認法定聯絡資料、產業類別、交付占比與客單價

操作步驟與完成後的結果

每一項操作都列出從哪裡開始、要做什麼,以及完成後應該看到的結果。

1

選擇要連接的服務

從總覽辨識狀態,並前往真正的設定位置。

整合金鑰、付款與交付:開店前的安全設定

繁體中文字幕預設開啟;若和瀏覽器即時字幕重複,可在這裡關閉。

QA 驗收商品的公開商品頁,游標停在加入購物車按鈕。影片附可開關的繁體中文字幕、逐字稿與章節索引。

  1. 1

    這一步要做

    從網站後台按「整合與金鑰」,查看每列服務旁的「未設定」、「已設定」、「待驗證」、「已驗證」或「設定錯誤」。

    整合與金鑰總覽中的 PAYUNi 狀態

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    先從總覽辨識服務目前是未設定、已儲存、待驗證、已驗證或設定錯誤。
    1. 1核對
      位置:
      整合服務頁的 PAYUNi 狀態標籤。
      動作:
      確認 PAYUNi 顯示已連接或可驗證。
      結果:
      狀態不再是尚未設定,付款與物流功能才能使用。

    完成後會看到

    可以分辨哪些服務尚未開始、已保存、等待驗證、驗證通過或需要修正。

  2. 2

    這一步要做

    在要處理的服務列按「前往設定」。

    PAYUNi 列的前往設定入口

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    按前往設定,進入真正保存 PAYUNi 憑證的商店整合卡。
    1. 2操作
      位置:
      PAYUNi 整合卡片右側的「前往設定」按鈕。
      動作:
      按「前往設定」。
      結果:
      系統會開啟 PAYUNi 金鑰設定頁。

    完成後會看到

    畫面開啟該服務真正保存設定的功能頁與憑證卡。

注意事項

  • 總覽只列目前已啟用功能會用到的服務。
開啟這項操作的獨立教學頁
2

取得並保存必要憑證

依卡片引導取得同一帳號與環境的憑證,並安全保存。

這一段也收錄在同一支教學影片裡。回到影片查看章節

  1. 3

    這一步要做

    在憑證卡展開「如何取得這些資料?逐步引導」,照卡片列出的第三方後台位置準備每個欄位。

    PAYUNi 卡片的逐步引導

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    展開逐步引導,再依第三方後台的位置準備資料。
    1. 3操作
      位置:
      PAYUNi 整合卡片顯示「尚未設定」的狀態。
      動作:
      進入 PAYUNi 設定流程。
      結果:
      設定完成後,狀態會改為已連接或可驗證。

    完成後會看到

    取得與欄位名稱相符,而且屬於同一個帳號與環境的 ID、Key、Secret、Email 或其他設定值。

  2. 4

    這一步要做

    申請 PAYUNi 時,先複製網站名稱、網址與營運說明,再由店主依實況填寫聯絡資料、產業、交付占比、履約保證與平均客單價。

    PAYUNi 申請頁入口與申請資料說明

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    網站資料可複製;法定聯絡與營運資料仍須店主依實況填寫。
    1. 4核對
      位置:
      PAYUNi 整合卡片右側的申請連結。
      動作:
      需要商店帳號時按「開啟 PAYUNi 申請頁」。
      結果:
      系統會在新分頁開啟 PAYUNi 官方申請頁。

    完成後會看到

    申請內容和實際營運一致,而且只申請網站目前支援的付款工具。

  3. 5

    這一步要做

    把值貼到同名欄位,移除前後空白後按「儲存」。

    PAYUNi MerID、Hash Key 與 Hash IV 欄位

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    三個憑證欄位必須屬於同一個 PAYUNi 商店。
    1. 5核對
      位置:
      PAYUNi 設定頁的 MerID、Hash Key 與 Hash IV 欄位。
      動作:
      逐欄貼上商店自己的 PAYUNi 正式金鑰。
      結果:
      三個欄位都有值,且沒有前後空白。
    PAYUNi 憑證卡的儲存邊界

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    本教學只指出儲存邊界,不輸入或送出任何秘密。
    1. 5核對
      位置:
      PAYUNi 金鑰設定頁右上角的「儲存」。
      動作:
      確認三個欄位後按「儲存」。
      結果:
      金鑰會保存,接著可以執行連線驗證。

    完成後會看到

    畫面顯示已儲存;秘密欄位重新整理後只顯示遮罩或已儲存標記。

注意事項

  • 秘密欄位留空代表保留原值;只有勾「清除此金鑰」才會刪除。不要把秘密值放進公開文字、截圖或客服訊息。
開啟這項操作的獨立教學頁
3

執行支援的連線驗證

把已保存與第三方服務實際接受的設定分開判斷。

這一段也收錄在同一支教學影片裡。回到影片查看章節

  1. 6

    這一步要做

    服務卡若有「驗證設定」,請在儲存後按一次。

    ECPay 卡片的驗證設定按鈕

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    已儲存不等於已驗證;只有支援即時驗證的服務才有這個按鈕。
    1. 6核對
      位置:
      整合設定頁下方的「驗證設定」按鈕。
      動作:
      按「驗證設定」。
      結果:
      畫面會回報連線驗證結果。

    完成後會看到

    按鈕顯示「驗證中…」,完成後出現通過、警告或可修正的錯誤。

  2. 7

    這一步要做

    若驗證失敗,依錯誤訊息核對帳號、環境、權限、網域、Key 或 Secret;修正並儲存後,再按一次「驗證設定」。

    ECPay 卡片的驗證設定按鈕

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    已儲存不等於已驗證;只有支援即時驗證的服務才有這個按鈕。
    1. 7核對
      位置:
      整合設定頁下方的「驗證設定」按鈕。
      動作:
      按「驗證設定」。
      結果:
      畫面會回報連線驗證結果。

    完成後會看到

    設定正確時顯示已驗證;只有建議事項時顯示警告,不會假裝完全通過。

注意事項

  • 不是每一種服務都有即時驗證。PAYUNi 沒有這個按鈕,不能把已儲存描述成已驗證。
開啟這項操作的獨立教學頁
4

完成第三方後台仍需要的設定

把平台提供的回呼網址、webhook 或 DNS 值正確交給第三方服務。

這一段也收錄在同一支教學影片裡。回到影片查看章節

  1. 8

    這一步要做

    若卡片要求回呼網址、webhook 或 DNS,從逐步引導找到要複製的值與第三方後台入口。

    PAYUNi 卡片的逐步引導

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    展開逐步引導,再依第三方後台的位置準備資料。
    1. 8操作
      位置:
      PAYUNi 整合卡片顯示「尚未設定」的狀態。
      動作:
      進入 PAYUNi 設定流程。
      結果:
      設定完成後,狀態會改為已連接或可驗證。
    PAYUNi 貨態 Notify URL

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    用複製按鈕取得完整網址,收到第一筆貨態才證明接通。
    1. 8核對
      位置:
      PAYUNi 物流設定頁顯示的貨態 Notify URL。
      動作:
      複製這個網址到 PAYUNi 後台的 Notify URL 欄位。
      結果:
      PAYUNi 能把最新貨態回傳到訂單。

    完成後會看到

    畫面提供服務專用的值、複製按鈕或外部後台連結。

  2. 9

    這一步要做

    把值貼到第三方後台指定欄位並儲存;DNS 記錄要逐筆核對類型、主機與值。

    PAYUNi 貨態 Notify URL

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    用複製按鈕取得完整網址,收到第一筆貨態才證明接通。
    1. 9核對
      位置:
      PAYUNi 物流設定頁顯示的貨態 Notify URL。
      動作:
      複製這個網址到 PAYUNi 後台的 Notify URL 欄位。
      結果:
      PAYUNi 能把最新貨態回傳到訂單。

    完成後會看到

    第三方服務接受並保存這個網站的回呼、webhook 或 DNS 設定。

  3. 10

    這一步要做

    回安庭重新驗證或查看狀態;PAYUNi 物流則要等第一筆貨態回來。

    PAYUNi 7-ELEVEN 店到店開通進度

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    第一與第三步由系統判斷;物流申請與貼網址須由店主確認。
    1. 10核對
      位置:
      PAYUNi 物流設定頁的 7-ELEVEN 店到店開通進度。
      動作:
      依進度完成申請、審核與啟用。
      結果:
      狀態會顯示目前開通階段與下一步。
    整合與金鑰總覽中的 PAYUNi 狀態

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    先從總覽辨識服務目前是未設定、已儲存、待驗證、已驗證或設定錯誤。
    1. 10核對
      位置:
      整合服務頁的 PAYUNi 狀態標籤。
      動作:
      確認 PAYUNi 顯示已連接或可驗證。
      結果:
      狀態不再是尚未設定,付款與物流功能才能使用。
    ECPay 卡片的驗證設定按鈕

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    已儲存不等於已驗證;只有支援即時驗證的服務才有這個按鈕。
    1. 10核對
      位置:
      整合設定頁下方的「驗證設定」按鈕。
      動作:
      按「驗證設定」。
      結果:
      畫面會回報連線驗證結果。

    完成後會看到

    可驗證的服務更新狀態;PAYUNi 開通進度的第三步收到貨態後顯示已接通。

注意事項

  • PAYUNi checklist 只有第一步金鑰與第三步貨態可由系統判斷;第二步物流申請與貼網址必須由店主人工確認。
開啟這項操作的獨立教學頁
5

用安全測試確認資料真的往返

用不扣款、自己的測試資料,確認平台與第三方服務都留下同一筆結果。

這一段也收錄在同一支教學影片裡。回到影片查看章節

  1. 11

    這一步要做

    依服務執行安全測試,例如送出自己的測試表單、走沙盒結帳,或從自己的 LINE 帳號傳一則測試訊息。

    付款頁目前的金流模式

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    核對測試或正式模式,並使用店家自己所屬環境的憑證。
    1. 11核對
      位置:
      付款與發票頁的「付款模式」設定。
      動作:
      依目前用途選擇測試或正式環境。
      結果:
      測試期間不會誤送正式交易;上線前可明確切換正式環境。
    公開商品頁的加入購物車入口

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    設定齊全後,下一步是走一筆明確不扣款的完整測試單。
    1. 11核對
      位置:
      公開商品頁的「加入購物車」按鈕。
      動作:
      從訪客端實際按一次加入購物車。
      結果:
      商品會進入購物車,證明銷售模式與商品狀態都正確。

    完成後會看到

    第三方服務與安庭後台都留下時間與內容相符的測試結果。

  2. 12

    這一步要做

    回到對應功能頁查看收件箱、訂單、寄送紀錄或訊息中心,核對剛才的測試資料。

    公開商品頁的加入購物車入口

    手機可左右滑動畫面,看清楚紅圈與欄位文字。

    設定齊全後,下一步是走一筆明確不扣款的完整測試單。
    1. 12核對
      位置:
      公開商品頁的「加入購物車」按鈕。
      動作:
      從訪客端實際按一次加入購物車。
      結果:
      商品會進入購物車,證明銷售模式與商品狀態都正確。

    完成後會看到

    後台找到同一筆測試資料,證明服務不是只有已設定,而是真的有資料往返。

注意事項

  • 金流測試只用沙盒或明確不扣款的方式;不要為了測試刷正式客戶款項。
開啟這項操作的獨立教學頁

遇到問題先看這裡

金鑰看起來正確,驗證卻失敗?
確認金鑰屬於正確帳號與環境,權限足夠且沒有多餘空白;不要把測試金鑰當正式金鑰,也不要把金鑰貼到客服公開訊息。
PAYUNi 商店申請要填哪些資料?
PAYUNi 設定卡會整理可複製的商店名稱、網址與營運說明,並直達新增商店頁;聯絡資料、產業類別、交付占比、履約保證與平均客單價仍要由店主依實際營運填寫。平台目前支援信用卡一次付清、ATM 與超商代碼。
PAYUNi 物流申請表的「貨態 Notify URL」要填什麼?
填你這個網站專屬的一行網址,PAYUNi 收送貨進度時會通知到那裡。兩個地方都拿得到、內容一樣:整合服務頁的 PAYUNi 金鑰卡,或商店設定的「配送與取貨 → 超商取貨 → 出單方式選 PAYUNi」開通進度卡,都有一鍵複製。請用複製的不要手打,少一個字元的症狀是貨態永遠不會來且沒有任何錯誤訊息。這一欄是商店層級設定一次,與收款金鑰共用同一個 PAYUNi 商店,不必另外申請物流金鑰;還沒在平台開啟超商取貨也可以先貼、先送件。
包裹已經寄出,訂單卻一直沒有貨態?
先看出單方式:自行開單(賣貨便等)本來就沒有貨態回報,賣家平台沒有提供介接。走 PAYUNi 或綠界物流卻沒貨態,最常見的是貨態網址沒貼或貼錯一個字元——到「配送與取貨」看開通進度卡,超過兩天沒有任何回報時它會直接指出這一點,回 PAYUNi 後台的物流申請頁重貼即可。
不是這個問題?查全部排除方法

逐步操作

需要一步一步做時,接著看詳細教學

相關功能

還是沒解決?

依你看到的狀況查一次問題排除,通常比找功能名稱快。真的卡住就直接告訴我們,把你正在做的事和畫面上的訊息寫進來就好。