品牌管理操作手冊

這份文件教你： 如何把您旗下的多家商家群組成一個「品牌」、取得一組共用的對接金鑰（Client ID 與 Secret Key）、以及日後怎麼加入或撤銷商家、換發或停用金鑰。適合集團窗口、總部管理人員閱讀。

一、功能簡介

如果您名下有多家商家（例如同一集團的各地門市），過去每一家都要各自對接、各拿一組金鑰。「品牌管理」讓您把這些商家歸成一個品牌，整個品牌只用一組金鑰，對接一次就涵蓋旗下所有商家。日後有新門市加入，只要把它加進品牌，不必重新對接。

ℹ️ 一家商家同時只能屬於一個品牌。 若某家商家已在別的品牌裡，要先從那邊撤銷才能加進來。

二、進入品牌管理

在商家後台右上角點您的名字展開選單，選「進品牌管理」。

這張圖您會看到：右上角展開的選單，最下方有一個「進品牌管理」。

ℹ️ 沒看到這個選項，表示您的帳號還沒開通這個功能。請洽客服協助開通。

進來後會看到您管理的所有品牌。每張卡片顯示品牌名稱、說明、以及底下有幾家商家。

這張圖您會看到：三個品牌，右上角有「建立新品牌」。品牌名稱旁的彩色標籤代表金鑰目前的狀態（第四章會逐一說明）。

三、建立品牌並取得金鑰

步驟 1｜填品牌資訊

點右上角「建立新品牌」，跳出的畫面分兩步。第一步填品牌名稱（必填）與說明（可不填）。

填好後「下一步」才會亮起來。

步驟 2｜選擇要一起加入的商家

第二步會列出您名下的商家，勾選要一併加入這個品牌的。這一步可以跳過，建立完之後再慢慢加也行。

這張圖您會看到：您名下商家的清單，每一列是商家名稱與統一編號。已經屬於其他品牌的商家會變灰、無法勾選，並標示它在哪個品牌。

商家很多時，用上方搜尋框輸入名稱或統一編號快速篩選。

按下送出後，系統會自動向 DDPay 申請金鑰。

ℹ️ 金鑰要有「金流已開通」的商家才申請得到。 如果第二步跳過沒選商家、或勾選的商家旗下商店金流都還沒開通，品牌會先建立起來、標籤顯示「尚未產生金鑰」；之後到「串接管理」按「產生金鑰」即可（見第四章）。

步驟 3｜把金鑰更新到對接系統

申請成功後會跳出這個畫面，一次給您三樣東西：品牌識別碼、Client ID、Secret Key。請把它們更新到您的對接系統。

ℹ️ Secret Key 之後還能再取得。 關閉這個畫面後，回到「串接管理」按 Secret Key 右側的複製鈕，系統會向 DDPay 取回並複製到剪貼簿（每次取回都會留異動紀錄）。

這張圖您會看到：三個欄位各自右邊都有一顆複製鈕，按下後圖示會變成綠色勾勾。Secret Key 那欄是黃底、下方提醒 Secret Key 等同密碼、請勿外流。

⚠️ Secret Key 等同密碼、請勿外流或貼在公開頻道。 若懷疑外流，請按「註銷金鑰」暫停對接、再按「重新產生金鑰」換發（見第八章）。

步驟 4｜之後隨時可以回來看、也能再複製

關閉後回到「串接管理」，這裡隨時查得到品牌識別碼與 Client ID。Secret Key 平時只顯示末 4 碼；需要完整內容時按右側複製鈕，系統會向 DDPay 取回並直接複製到剪貼簿、不會顯示在畫面上。三顆複製鈕按下後圖示都會變成綠色勾勾、代表已複製。

四、金鑰的狀態標籤

品牌名稱旁與「串接管理」頁上方的標籤，代表金鑰目前的狀況：

尚未產生金鑰：只有品牌識別碼，還沒有 Client ID 與 Secret Key。畫面會依情況提示是要先加入商家、還是等金流開通後按「產生金鑰」。

還沒有商家時，「品牌商家」是空的，畫面會直接給您加入的入口。

N 間商店金流未開通：這個標籤會出現在品牌卡片、「串接管理」與「品牌商家」的商家列上，把滑鼠移到標籤上會有說明。不影響其他已開通商店的對接。

金鑰已註銷：Secret Key 欄位會顯示「已註銷、對外對接失敗」。品牌底下的商家、管理員都還保留著。

五、管理品牌管理員

點左側「品牌管理員」，看得到誰能協助管理這個品牌。您自己那一列會有「你」的標記。

ℹ️ 管理員之間權限相同，都能加入／撤銷商家、發邀請、換發或停用金鑰、以及再邀請其他管理員。

5.1 邀請管理員

點右上角「邀請管理員」，按「發行網址」產生邀請網址後傳給對方。

5.2 撤銷管理員

在該管理員那一列點「撤銷」並確認。

⛔ 兩個限制：不能撤銷自己（您那一列的操作欄會是「—」，需要由其他管理員操作）；最後一位管理員也不能撤銷，否則這個品牌就沒人管得了。

六、管理品牌商家

點左側「品牌商家」，看得到目前加入的每一家，以及各自的加入時間。商家名稱旁若有「N 間商店金流未開通」標籤，表示那幾間商店暫時不在金鑰授權範圍、開通後會自動納入。

6.1 加入商家：兩種方式

點右上角「邀請商家」，跳出的畫面有兩個頁籤。

方式一：直接加入（適合商家本來就在您名下）

切到「直接加入」頁籤，勾選要加入的商家後送出，立即生效、不需對方確認。

方式二：邀請網址（適合商家在別人的帳號底下）

在「邀請連結」頁籤按「發行網址」，系統產生一組網址並自動複製，您把它傳給對方即可。

⚠️ 邀請網址 24 小時內有效，而且對方一接受就立刻失效。 需要邀請多家不同帳號的商家時，按「另產一組」逐一發送——舊的那組不會因此失效。

6.2 撤銷商家

在該商家那一列點「撤銷」並確認。撤銷後這家商家就不在品牌的授權範圍內。

⛔ 最後一家商家不能撤銷。 品牌至少要保留一家商家，否則對接會中斷。只剩一家時「撤銷」會是灰色、按不下去。若真的要整個停掉這個品牌的對接，請改用「註銷金鑰」（見第八章）。

七、對方收到邀請網址後會看到什麼

7.1 管理員邀請

對方點開網址（需要先登入自己的商家後台），會看到確認畫面。

按「接受邀請」後即成為品牌管理員，可以直接進品牌管理。

7.2 商家邀請

對方會看到自己名下的商家清單，勾選要加入這個品牌的。已屬於其他品牌的商家會標示出來、無法勾選。

勾選後「接受邀請」才會亮起來。

送出後顯示加入成功。

7.3 網址已經被用過或超過 24 小時

會顯示已失效。請重新發行一組新網址給對方。

八、換發與停用金鑰

這兩個動作都在「串接管理」右上角，都需要打出完整品牌名稱才能送出，避免誤按。

8.1 重新產生金鑰（換一組新的）

適用情境：懷疑 Secret Key 外流。若只是沒存到、不需要換發，到「串接管理」按複製鈕取回即可（見步驟 4）。

打入品牌名稱後，確認鈕才會亮起來。

⛔ 舊金鑰會立刻失效。 換發後請盡快把新的 Client ID 與 Secret Key 更新到您的對接系統，否則收款會中斷。

⚠️ 換發後品牌識別碼也會跟著換一版（例如結尾多了 -v2）。這是金流系統的規定、每次換發都會產生新的版本號。如果您或廠商有把品牌識別碼寫死在系統裡，記得一併更新。

8.2 註銷金鑰（整個停掉對接）

適用情境：確定不再使用這個品牌對接。

註銷後對外對接會失敗，但品牌底下的商家、管理員、異動紀錄都保留著。之後要恢復，按「重新產生金鑰」即可重新啟用並拿到一組新金鑰。

九、異動紀錄

品牌的每一筆操作都會留存，永久保存供日後查核。

「品牌管理員」「品牌商家」「串接管理」的異動都在這裡，可以依功能名稱篩選、或用操作者姓名搜尋。

回到品牌列表後（點左上麵包屑「品牌管理」、或「切換品牌」下拉裡的「所有品牌」），左側的「異動紀錄 · 全部品牌」則是把您所有品牌的紀錄合在一起看，多一個「品牌」欄位。

ℹ️ 「來源」欄告訴您這筆是怎麼發生的：手動（有人在畫面上操作）、透過邀請連結（對方點網址接受）、系統（系統自動處理）。

十、常見情境

10.1 我把 Secret Key 弄丟了

不必重新產生。到「串接管理」按 Secret Key 右側的複製鈕，系統會向 DDPay 取回並複製到剪貼簿（這個動作會留異動紀錄）。只有懷疑外流時才需要「重新產生金鑰」。

10.2 新開了一家門市要加進來

如果那家商家在您名下 → 「品牌商家」→「邀請商家」→「直接加入」頁籤勾選送出，立即生效。
如果在別人帳號底下 → 同一個畫面用「邀請連結」發行網址傳給對方。

10.3 建好品牌了，但一直是「尚未產生金鑰」

可能是還沒有商家，或旗下商店的金流都還沒開通。到「品牌商家」加入商家；金流開通後到「串接管理」按「產生金鑰」。

10.4 看到「N 間商店金流未開通」是什麼意思

那幾間商店的金流服務還在開通中，暫時不在品牌金鑰的授權範圍，開通後系統會自動納入、不需要操作。到「品牌商家」可以看到是哪幾家。若久未開通，請洽客服並提供您的品牌識別碼。

10.5 想把某家門市改掛到另一個品牌

一家商家同時只能屬於一個品牌。先在原本的品牌把它「撤銷」，再到新品牌加入。若它是原品牌的最後一家，請先加入別家、或直接註銷原品牌的金鑰。

10.6 想確認某個操作是誰做的

到「異動紀錄」用操作者姓名搜尋，或依功能名稱篩選。紀錄永久保存。

ℹ️ 關於畫面提示：目前操作完成後畫面會直接重新載入，不會另外跳出成功訊息。請從清單或狀態標籤確認結果是否如預期。