交給工程師串接前的準備

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

準備清單

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

1. 開啟 API 串接

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

開啟後，CRM 會出現：

• 左側選單「金流管理」→「金流API」：連到 API 文件。
• 左側選單「金流管理」→「定期購買」：管理用 API 建立的定期扣款。
• 「總設定」→「開發者」分頁的「應援金流設定」：產生 token、設定通知網址。

2. 指派權限

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

3. 產生 token

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

重新產生 token 會讓舊的立刻失效

• 按下「重新產生 Token」沒有確認視窗，舊 token 會立刻失效，正在串接中的系統會馬上無法呼叫 API。確定要換之前，先跟工程師約好時間。
• 離開頁面後就看不到完整的 token 了。忘記複製的話，只能重新產生。
• token 就像密碼，只交給需要的工程師，不要貼在 email、聊天群組或 AI 工具裡。

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

4. 設定付款通知網址

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

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

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

5. 申請固定 IP

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

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

1. 請工程師提供正式環境伺服器呼叫 API 時使用的固定對外 IP。
2. 聯絡應援客服或業務，提供你的網域名稱與這些 IP。
3. 應援完成設定後會通知你，工程師就可以開始呼叫正式環境。

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

6. 把這些交給工程師

• 網域名稱（例如 ming）
• 測試環境與正式環境的 token
• 通知網址已設定好的確認
• 固定 IP 開通的確認
• 本站的開發者快速開始

常見問題

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

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

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