在開發與部署過程中,請務必確認使用正確的環境與憑證。
環境總覽
| 環境 | 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 可能不支援所有支付方式或完整支付流程。
Live Testing(測試環境)
適用於:- 驗證真實支付流程
- 測試 QR Code 與電子錢包支付
- 上線前進行完整端對端測試(End-to-End Testing)
Production(正式環境)
適用於:- 系統已完成測試
- 準備正式接受真實交易
- 需要進行結算與對帳
重要說明
若使用錯誤環境的 Base URL 或憑證,將導致驗證失敗或簽章錯誤。
部署前請與 QFPay 確認應使用的環境與對應憑證組合。
建議流程
- 於 Sandbox 進行開發與功能測試
- 於 Live Testing 驗證實際支付流程
- 部署至 Production 正式上線
