> ## 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 OpenAPI 發送您的第一筆支付請求。
## 概覽
本快速開始指南將帶您完成：
1. 建立一筆支付請求
2. 接收並處理支付完成通知
完成本流程後，您將具備基本的 QFPay OpenAPI 整合能力。
***
## 步驟 1 — 準備 API 憑證
使用 QFPay OpenAPI 前，您需要以下憑證：
* `app_code`
* `client_key`
* `mchid`（如有分配）
若尚未取得憑證，請聯絡 QFPay 技術支援。
***
## 步驟 2 — 準備請求參數
```json JSON theme={null}
{
"app_code": "YOUR_APP_CODE",
"out_trade_no": "ORDER_1001",
"total_fee": "100",
"pay_type": "801",
"notify_url": "https://example.com/callback"
}
```
說明：
* `out_trade_no`：商戶端訂單編號（需保持唯一）
* `total_fee`：交易金額（單位依 API 規範定義）
* `notify_url`：支付完成後接收非同步通知的網址
***
## 步驟 3 — 產生請求簽章
請使用您的 `client_key` 對所有請求參數進行簽章。
完整簽章規則請參閱：
**Signature Generation（簽章產生說明）**
***
## 步驟 4 — 發送支付請求
```http HTTP theme={null}
POST https://api.qfapi.com/trade/v1/payment
Content-Type: application/json
```
請將簽章後的參數作為請求內容發送至 API 端點。
***
## 步驟 5 — 處理回應結果
```json JSON theme={null}
{
"respcd": "0000",
"pay_url": "https://..."
}
```
當 `respcd = 0000` 時表示請求成功。
請使用回傳的：
* `pay_url`\
或
* QR Code
引導客戶完成支付流程。
***
## 步驟 6 — 接收支付完成通知
當支付完成後，QFPay 會向您設定的 `notify_url` 發送非同步通知。
請確保您的接收端：
* 支援 `POST` 請求
* 驗證通知簽章
* 成功處理後回傳 HTTP `200 OK`
建議同時使用「交易查詢 API」確認最終狀態。
***
## 選用：本機測試
使用 ngrok 或類似工具將本機服務公開：
```bash Bash theme={null}
ngrok http 8080
```
可匯入以下 Postman Collection 進行測試：
[https://sdk.qfapi.com/assets/files/qfpay\_openapi\_payment\_request.postman\_collection-c8de8c8fe69f3fcd5a7653d41c289a29.json](https://sdk.qfapi.com/assets/files/qfpay_openapi_payment_request.postman_collection-c8de8c8fe69f3fcd5a7653d41c289a29.json)
***
## 下一步
了解如何安全地產生與驗證簽章。
正確處理支付狀態更新。
查看支援的支付代碼。
使用 Sandbox 環境進行測試。