跳轉到主要內容
QFPay OpenAPI 提供三種環境:Production(正式環境)Live Testing(測試環境) 以及 Sandbox(模擬環境) 每個環境皆有不同用途與對應的 Base URL。
在開發與部署過程中,請務必確認使用正確的環境與憑證。

環境總覽

環境Base URL用途
Production(正式)https://openapi-hk.qfapi.com真實交易與結算
Live Testing(測試)https://test-openapi-hk.qfapi.com使用測試帳號進行真實流程測試(不進行結算)
Sandbox(模擬)https://openapi-int.qfapi.com模擬交易,用於開發與功能測試

各環境使用時機

Sandbox(模擬環境)

適用於:
  • 初期開發
  • 驗證 API 連線與簽章機制
  • 模擬信用卡交易
  • 驗證請求與回應處理流程
Sandbox 不會扣除真實資金。
Sandbox 可能不支援所有支付方式或完整支付流程。

Live Testing(測試環境)

適用於:
  • 驗證真實支付流程
  • 測試 QR Code 與電子錢包支付
  • 上線前進行完整端對端測試(End-to-End Testing)
使用測試帳號進行的交易不會產生實際結算。若使用真實支付方式進行測試,請務必立即執行退款操作。

Production(正式環境)

適用於:
  • 系統已完成測試
  • 準備正式接受真實交易
  • 需要進行結算與對帳
正式環境將產生實際交易與資金流動。

重要說明

若使用錯誤環境的 Base URL 或憑證,將導致驗證失敗或簽章錯誤。
部署前請與 QFPay 確認應使用的環境與對應憑證組合。

建議流程

  1. Sandbox 進行開發與功能測試
  2. Live Testing 驗證實際支付流程
  3. 部署至 Production 正式上線