更新紀錄

文件

2026-09 新文件網站

• Payment API 文件從 Postman 移到本站，依正式環境 v10.3.1.1 逐項核對。舊的 Postman 文件保留但不再更新。
• 新增：存卡與後續扣款（/checkout-token、/token/transactions、/token/subscriptions）、付款通知的完整欄位、錯誤碼一覽、固定 IP 白名單、環境與測試、商家操作指南。
• 更正舊文件：
  • 所有建立交易的 API 都必須帶 productDetails，品項合計要等於 amount。
  • 付款通知最多送 3 次，間隔約 2 秒、4 秒（舊文件寫 2、4、6 秒）。
  • 退款不只信用卡：Apple Pay、LINE Pay、超商代碼、ATM 都可以用 API 退。amount 不帶就是全額。
  • POST /checkout-schedule 的回應是 subscriptionHid，不是 transactionHid。
  • 失敗導回的 payment_error 不會是 V0001。
  • 「金額大於 100 元成功」不是應援系統的規則，請不要依賴。
• 新增 OpenAPI 定義檔 與 llms.txt。

Payment API

v10.3.1（2026-09）

• 結帳頁與綁卡頁會先擋下已過期的信用卡。
• 付款結果不明的交易不再自動重試扣款，避免重複扣款。

v10.3.0（2026-09）

• allowedPaymentMethods 在結帳頁實際生效：結帳頁照清單顯示付款方式並把關。信用卡仍然一定會出現，["cvs"] 是信用卡加超商代碼。
• 新增 409 C026（付款結果不明），回應帶 "retryable": false。
• 綁卡頁（/checkout-token）與預約定期定額：部分收單機構綁卡時會先授權新台幣 1 元再退回，頁面會事先告知消費者。
• 定期定額的結帳頁，付款人 Email 改為必填。
• 修正定期定額在特定情況下停止扣款的問題。