交給工程師串接前的準備

工程師串接 Payment API 之前，有幾件事要由商家在後台或透過應援完成。照這一頁準備好，再把清單交給工程師。

準備清單

項目	誰做	在哪裡
1. 金流已開通	商家申請、應援審核	開通金流與付款方式
2. 開啟 API 串接（開發者模式）	請應援開啟	聯絡業務或客服
3. 指派工程師的後台權限	商家	CRM「團隊權限」
4. 產生 token	商家或工程師	CRM「總設定」→「開發者」
5. 設定付款通知網址	工程師提供網址	CRM「總設定」→「開發者」
5-1. 產生付款通知簽章密鑰（建議）	商家或工程師	CRM「總設定」→「開發者」→「應援金流設定」
6. 送出正式環境 IP	工程師提供 IP，商家在 CRM 送出	CRM「總設定」→「開發者」→「正式環境設定」
7. 測試環境帳號	請應援協助	聯絡業務或客服

1. 開啟 API 串接

API 串接（開發者模式）由應援開啟，商家後台沒有開關。新申請的商家通常已經開啟。

開啟後，CRM 會出現：

• 左側選單「金流管理」→「金流API」：連到 API 文件。
• 左側選單「金流管理」→「定期購買」：管理用 API 建立的定期扣款。
• 「總設定」→「開發者」分頁的「應援金流設定」：產生 token、設定通知網址、產生付款通知簽章密鑰。
• 同一區的「正式環境設定」：填寫正式環境 IP 與實質交易網址。

2. 指派權限

操作 token 與通知網址的人，要是後台管理員，或在「團隊權限」被指派「金流串接管理員」角色。權限不足時，「產生 Token」按鈕會是灰色的。

3. 產生 token

1. 進入 CRM「總設定」→「開發者」分頁，找到「應援金流設定」→「存取 Token」。
2. 按「產生 Token」。
3. 按「複製」，交給工程師。

重新產生 token 後，舊的最多還能用 7 天

• 按下「重新產生 Token」沒有確認視窗。新 token 立即生效，舊 token 最多 7 天後失效（舊 token 原本就快到期時會更早），請立即請工程師換上新 token。
• 從 2026-10-15 起產生的 token 一年後到期，到期前請重新產生並交給工程師。
• 離開頁面後就看不到完整的 token 了。忘記複製的話，只能重新產生。
• token 就像密碼，只交給需要的工程師，不要貼在 email、聊天群組或 AI 工具裡。

測試環境和正式環境的 token 是分開的，不能共用。測試環境的 token 要在測試環境的後台產生，測試環境帳號請聯絡應援協助。

4. 設定付款通知網址

付款完成時，應援會把結果送到你的系統。網址由工程師提供：

1. 在同一個「應援金流設定」區塊，找到「交易資料回傳網址位置」。
2. 貼上工程師提供的網址，必須是 https:// 開頭。
3. 按「確定送出」，看到「設定成功」就完成了。

退款、取消定期購買與續扣重試的通知需要應援另外開啟，有需要請告訴業務人員。

產生付款通知簽章密鑰（建議）

1. 在同一個「應援金流設定」區塊，找到「付款通知簽章密鑰」，按「產生簽章密鑰」。
2. 畫面只會顯示這一次，請直接交給工程師存到伺服器，不要貼在 email 或聊天群組。
3. 需要更換時按「輪替簽章密鑰」。舊密鑰會立即失效，請先和工程師約好時間。

權限不足時按鈕會是灰色的，請管理員指派「金流串接管理員」角色。工程師的驗證方式見確認通知的真假。

5. 送出正式環境 IP

正式環境一定要先綁定固定 IP

正式環境的 API 只接受已綁定的 IP。還沒綁定時，工程師呼叫正式環境會被擋下，測試環境則不受影響。

1. 請工程師提供正式環境伺服器呼叫 API 時使用的固定對外 IP（最多 3 組單一 IP）。
2. 進入正式環境 CRM「總設定」→「開發者」，找到「正式環境設定」，填入 IP 與「實質交易網址」（消費者付款的網站，https:// 開頭），按「送出設定」。
3. 申請狀態變成「審核中」。應援設定完成後狀態會變成「已設定完成」，並寄信通知你，工程師就可以開始呼叫正式環境。被退回時狀態是「退回」，畫面會顯示原因，修正後重新送出。

需要超過 3 組 IP 或使用網段，請聯絡業務人員。

透過合作平台（例如已和應援串接好的電商平台）收款的商家，不需要申請。

6. 把這些交給工程師

• 網域名稱（例如 ming）
• 測試環境與正式環境的 token
• 通知網址已設定好的確認
• 付款通知簽章密鑰（有產生的話）
• 正式環境設定已是「已設定完成」的確認
• 本站的開發者快速開始

常見問題

在後台找不到「金流API」選單或「開發者」分頁？ API 串接還沒開啟，或你的帳號沒有權限。請應援開啟，或請管理員指派「金流串接管理員」角色。

出現「產生存取 Token 失敗，請洽應援客服！」？ 請聯絡客服並告知網域名稱。

工程師說呼叫 API 一直回「未授權」？ 常見原因有三個：token 已過期或被重新產生超過 7 天、測試與正式環境的 token 用錯了、正式環境還沒綁定固定 IP。