> ## Documentation Index
> Fetch the complete documentation index at: https://sdk.qfapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 環境說明

> 了解 QFPay 各環境用途與開發部署階段的使用時機。

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 不會扣除真實資金。

<Note>
  Sandbox 可能不支援所有支付方式或完整支付流程。
</Note>

***

### Live Testing（測試環境）

適用於：

* 驗證真實支付流程
* 測試 QR Code 與電子錢包支付
* 上線前進行完整端對端測試（End-to-End Testing）

<Warning>
  使用測試帳號進行的交易不會產生實際結算。

  若使用真實支付方式進行測試，請務必立即執行退款操作。
</Warning>

***

### Production（正式環境）

適用於：

* 系統已完成測試
* 準備正式接受真實交易
* 需要進行結算與對帳

正式環境將產生實際交易與資金流動。

***

## 重要說明

<Note>
  若使用錯誤環境的 Base URL 或憑證，將導致驗證失敗或簽章錯誤。
</Note>

<Note>
  部署前請與 QFPay 確認應使用的環境與對應憑證組合。
</Note>

***

## 建議流程

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