01你需要
有權管理店舖設定的 HKTVmall MMS 帳戶,以及你的店舖編號(storeCode,例如 H0000001)。
02在 HKTVmall MMS
- 第 1 步登入 MMS。
- 第 2 步前往 Merchant → Merchant Store Status。
- 第 3 步找到 Enable Open API,設定為 Yes。
- 第 4 步把 UUID 及 Private key(私鑰) 複製並妥善保存。私鑰只會顯示一次。
- 第 5 步按 Save 儲存。 這是最多人漏掉的一步:未儲存的話,密鑰不會生效。
離開頁面前記得在 MMS 按 Save。日後如重新產生密鑰,舊的一組會即時失效,仍在使用舊密鑰的系統會停止運作。
03在 Startship
- 第 1 步前往 渠道 → 連接店舖 → HKTVmall。
- 第 2 步貼上 店舖編號(storeCode)、UUID 及 私鑰。
- 第 3 步按 連接。Startship 會向 HKTVmall 驗證連接,成功後會顯示你的店舖名稱。
04連接失敗怎麼辦
| 訊息 | 檢查甚麼 |
|---|---|
| 密鑰無效 | 私鑰未完整複製,或複製後又重新產生過密鑰。請在 MMS 重新產生一組、按 Save,再試一次。 |
| 找不到店舖 | 檢查店舖編號,要用 MMS 顯示的編號,不是店舖名稱。 |
| 未啟用 Open API | Enable Open API 仍然是 No,或更改未儲存。請設為 Yes 並按 Save。 |
05我的密鑰安全嗎?
你的私鑰會加密儲存,儲存後不會再傳回瀏覽器。Startship 只會顯示最後 4 個字元。