為確保平台穩定性與所有商戶的公平使用權益，QFPay 對 API 請求實施頻率限制（Rate Limiting）政策。
本頁說明請求限制規則、錯誤回應機制，以及建議的實作方式。
請求頻率限制
每個門店（SID）的標準請求頻率限制如下：
- 付款請求：每秒 30 次。
- 交易查詢：每秒 300 次。
共享 IP 及平台限制亦同時適用。超過限制的請求會收到 HTTP 429 Too Many Requests 回應。請降低請求頻率，並使用指數退避策略重試。
如需提高上限或預計出現流量高峰，請聯絡 technical.support@qfpay.com。
使用建議
為避免觸發限流並確保系統穩定運作，建議採取以下最佳實務：
- 批次處理請求
若 API 支援批次操作，應優先使用以降低請求次數。
- 優化查詢條件
合理使用篩選條件與分頁機制，避免高頻輪詢（Polling）。
- 實作快取機制
對於高重複性查詢（例如支付狀態查詢）應使用短期快取策略。
- 監控請求頻率
建立監控與日誌機制，追蹤 RPS 與錯誤率，避免突發性流量超標。
錯誤處理建議
當收到 HTTP 429 回應時，建議採取以下處理方式：
1. 實作重試機制
2. 使用指數退避策略（Exponential Backoff）
每次重試時逐步增加等待時間，例如：
- 第一次延遲 1 秒
- 第二次延遲 2 秒
- 第三次延遲 4 秒
- 依序遞增
此策略可降低再次觸發限流的風險。
請勿在收到 429 後立即大量重試，否則可能導致持續性封鎖或延長限流時間。
高峰流量管理
若預期流量可能大幅增加（例如促銷活動或大型檔期），請提前聯絡技術支援團隊：
technical.support@qfpay.com
提前通知可協助評估是否需要調整資源配置，以確保服務穩定。
建議整合流程
- 建立請求頻率監控
- 實作重試與退避策略
- 測試高併發情境
- 上線前確認峰值流量預估
妥善的流量管理可降低交易失敗與系統風險。 
