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

Publish Date | 2025/11/25 03:24
Author | 應援編輯部
流程

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

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

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

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

使用方式如下

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

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

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

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

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

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

第三步:開始串接

串接具體請參考 API 文件

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

測試卡號:

  1. 4242 4242 4242 4242
  2. 4000 0000 0000 2503(欲觸發 3D 驗證時使用)
  3. 5200 0000 0000 2151(欲觸發 3D 驗證時使用)
  4. 4012 8888 1888 8333(欲觸發失敗情境時使用)


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 需分開,無法共用。

功能導覽