跳到內容
應援科技應援金流文件

固定 IP 白名單

在 ChatGPT 開啟在 Claude 開啟

哪些會受影響

Section titled “哪些會受影響”
要綁定 IP 嗎
你的伺服器呼叫 payment-api.oen.tw 要
你的伺服器呼叫 payment-api.testing.oen.tw 不用
消費者打開應援結帳頁付款 不用
應援送付款通知給你 不用（方向相反）

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

準備固定的對外 IP

Section titled “準備固定的對外 IP”

你的伺服器呼叫 API 時，對外使用的 IP 必須固定：

  • 自己的主機或 VPS：通常就是主機的公開 IP。
  • 雲端服務（容器、Serverless、自動擴展的主機）：對外 IP 通常會變動，請設定 NAT Gateway 或固定出口 IP，讓所有呼叫都從固定的 IP 出去。
  • 有多台伺服器、多個區域或備援機房時，每一個出口 IP 都要申請。

要確認伺服器實際的對外 IP，可以在伺服器上執行 curl https://checkip.amazonaws.com。

申請

Section titled “申請”
  1. 準備要綁定的對外 IP（最多 3 組單一 IP，不接受網段或內網 IP），以及實質交易網址（消費者付款的網站，https:// 開頭）。
  2. 請商家進入正式環境 CRM「總設定」→「開發者」→「應援金流設定」→「正式環境設定」，填入 IP 與實質交易網址，按「送出設定」。申請狀態會變成「審核中」。
  3. 應援審核完成後，申請狀態變成「已設定完成」，並寄信通知商家的主要聯絡人。被退回時狀態是「退回」，畫面會顯示原因，修正後重新送出。
  4. 從伺服器呼叫一次查詢類的 API（例如查詢交易列表），確認不再回 403。
  • 需要超過 3 組 IP 或使用網段時，請聯絡業務人員。由業務設定後，CRM 這一區會變成唯讀。
  • 更換主機或出口 IP 時，請先在「正式環境設定」加上新的 IP、等到「已設定完成」再切換，避免中斷。拿掉的 IP 會列為「待移除」，審核時一併處理。

被擋下時會看到什麼

Section titled “被擋下時會看到什麼”
HTTP/1.1 403 Forbidden


{"message":"Forbidden"}
  • body 只有 message（通常是 Forbidden），沒有 code 欄位，和 API 自己的錯誤格式不同。
  • 用這點就能分辨：有 code: "A0001" 是 token 的問題；沒有 code 的 403 是 IP 還沒綁定。

付款通知的來源 IP

Section titled “付款通知的來源 IP”

你的防火牆需要限制來源時，請向應援索取付款通知的來源 IP。付款通知從固定的出口送出。