以下列出 QFPay 常見回應碼（respcd）與對應說明。

---

​

一般成功

---

​

請求與簽名錯誤

整合建議：

• 檢查參數格式與必填欄位
• 確認簽名排序與演算法
• 確保 out_trade_no 唯一

---

​

設備與門市狀態錯誤

整合建議：

• 確認門市與設備開通狀態
• 若持續發生，聯絡技術支援

---

​

訂單狀態相關

整合建議：

• 先使用交易查詢 API 確認最新狀態
• 避免直接重送支付請求

---

​

處理中狀態

整合建議：

• 請勿立即重試
• 使用交易查詢 API 輪詢確認狀態
• 建議實作延遲查詢機制

---

​

支付渠道錯誤

整合建議：

• 提示消費者更換支付方式
• 可允許重新發起交易

---

​

退款相關限制

整合建議：

• 查詢原交易狀態與可退款金額
• 確認支付渠道退款規則

---

​

系統或風控錯誤

整合建議：

• 可實作延遲重試機制
• 若涉及風控（1294），不建議自動重試
• 持續發生請聯絡技術支援

---

​

整合建議總結

1. 僅在明確可重試情境下實作重試機制
2. 對於 1143 / 1145 等狀態，使用查詢 API 確認結果
3. 避免在未知狀態下重複發送支付請求
4. 所有錯誤均應記錄完整日誌（含請求參數與回應碼）