應援金流 API 測試後台串接說明

Publish Date | 2025/09/04 03:07
Author | 應援編輯部
流程

聯絡業務取得測試後台 > 串接測試 > 填寫開通表單 > 啟用正式後台完成串接。

第一步：取得並登入測試後台

第一步：取得並登入測試後台 應援業務會開通測試後台，會發送一封後台權限邀請信，點進去後先註冊帳號，並按下同意後台權限，之後都從後台網域登入即可。

應援後台網域範例：XXXXXX.testing.oen.tw

使用方式如下

➊ 先找到權限邀請信，點選裏面的開通權限連結

➋ 用以下資料登入後 使用者帳號：nobody 使用者密碼：oenoen

➌ 然後輸入信箱 驗證碼任意輸入（測試後台不會真的寄出，隨便填即可）

第二步：找到串接用的資料

第二步：找到串接用的資料 ➍ 在網域首頁右上方選擇「管理後台」

進去後左側選單拉到最下方，找到總設定，選擇「開發者選項」 在開發者選項可生成 token 資料並填入回傳網址

第三步：開始串接

串接具體請參考 API 文件

測試信用卡（測試金額不得低於 100）

Visa: 4 開頭

Master: 5 開頭

Success：4242 4242 4242 4242

Fail：4242 4242 0000 0000

JCB: 3528, 3589, 2123, 1800

MCP AI 串接（BETA）

先下載 Claude

到本地端 安裝 MCP 套件：MCP 教學文件

填入 Token 與商號（xxxxx.testing.oen.tw 的 xxxxxx）

開通正式環境
  1. 測試環境確認串接順利
  2. 與業務聯絡確認費率（參考首頁）
  3. 填寫開通表單連結：個人戶｜公司戶
常見問題

💡 請問 WEBHOOK Callback 的時機點？與相關議題。

  1. 交易錯誤發生時 會回傳嗎？ 會
  2. 只有交易成功時 會回傳嗎？ 會
  3. 如果交易錯誤會回傳，那 status 會回傳什麼？ failed ，可以參考 message 欄位裡面有失敗理由
  4. webhook callback 有 ip 可以提供綁定嗎？沒有
  5. webhook callback 失敗時, 多久會重試？3次，看有沒有正常回覆 response code 2nd，第一次 2 秒 第二次 4 秒 第三次 6 秒

💡 金流測試環境是否可以測試超商&ATM？

A：可以，但不會自動 Callback。

💡 能否串接電子發票 API 開立發票？

A：應援代開發票與交易 API 綁再一起，未提供單獨開立發票 API。

💡 金流狀態已建立付款意向是什麼情境？

A：當消費者點選結帳，跳轉至應援結帳頁面但未完成送出交易時，即會顯示此狀態。

💡 能否使用同一個應援 Domain 販售小物也串接金流API?

A：domain 需分開，無法共用。

功能導覽