Skip to main content
本頁提供使用 Visa 與 Mastercard 進行線上信用卡支付的整合說明。
目前於香港環境支援主要國際信用卡品牌之線上交易。

​
整合方式選擇

商戶可依需求選擇以下其中一種整合方式：

​
1️⃣ 託管結帳頁面（Checkout）

適用情境：
  • 希望快速上線
  • 希望降低 PCI 合規負擔
  • 不自行處理卡資料
特點：
  • 由 QFPay 提供託管式支付頁
  • 內建 3D Secure 支援
  • PCI 風險最低

​
2️⃣ 支付組件（Payment Element SDK）

適用情境：
  • 需要完全自訂 UI / UX
  • 需與現有頁面深度整合
  • 希望保留品牌一致性
特點：
  • 卡號輸入欄位嵌入商戶頁面
  • 支援 3D Secure
  • 提供較高前端控制權
若不確定應選擇哪種整合方式，請依您的上線文件或聯繫 QFPay 技術支援團隊評估。

​
非同步通知機制（Webhook）

交易完成後，QFPay 將透過非同步通知（Webhook）將最終交易結果推送至商戶後台。
商戶需：
  • 接收通知
  • 驗證簽名
  • 根據通知更新訂單狀態

​
通知範例

Webhook Notification Example

​
重要注意事項

請務必驗證通知簽名。
不可僅依賴未驗證的通知資料更新訂單狀態。
respcd = 0000 代表交易成功。
其他狀態請依狀態碼文件處理。

​
補充確認機制

若出現以下情況，建議主動使用 交易查詢 API 補充確認：
  • 未收到通知
  • 通知延遲
  • 簽名驗證失敗
  • 系統處理異常
此方式可避免漏單或錯誤入帳。

​
測試卡資訊（Sandbox）

以下卡號可於 測試環境（Sandbox） 使用，用於模擬各類交易結果（包含 3D Secure）：
測試卡僅限 Sandbox 環境使用。
請勿於正式環境（Production）使用測試卡號。

​
小結

  • 支援 Visa 與 Mastercard 線上交易
  • 提供 Checkout 與 Element 兩種整合方式
  • 必須實作 Webhook 與簽名驗證
  • 建議搭配交易查詢 API 作為補充保障