跳轉到主要內容

​
概覽

本快速開始指南將帶您完成：
  1. 建立一筆支付請求
  2. 接收並處理支付完成通知
完成本流程後，您將具備基本的 QFPay OpenAPI 整合能力。

​
步驟 1 — 準備 API 憑證

使用 QFPay OpenAPI 前，您需要以下憑證：
  • app_code
  • client_key
  • mchid（如有分配）
若尚未取得憑證，請聯絡 QFPay 技術支援。

​
步驟 2 — 準備請求參數

JSON
{
  "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
POST https://api.qfapi.com/trade/v1/payment
Content-Type: application/json
請將簽章後的參數作為請求內容發送至 API 端點。

​
步驟 5 — 處理回應結果

JSON
{
  "respcd": "0000",
  "pay_url": "https://..."
}
當 respcd = 0000 時表示請求成功。請使用回傳的：
  • pay_url
    或
  • QR Code
引導客戶完成支付流程。

​
步驟 6 — 接收支付完成通知

當支付完成後，QFPay 會向您設定的 notify_url 發送非同步通知。請確保您的接收端：
  • 支援 POST 請求
  • 驗證通知簽章
  • 成功處理後回傳 HTTP 200 OK
建議同時使用「交易查詢 API」確認最終狀態。

​
選用：本機測試

使用 ngrok 或類似工具將本機服務公開：
Bash
ngrok http 8080

​
下一步

驗證與簽章機制

了解如何安全地產生與驗證簽章。

非同步通知處理

正確處理支付狀態更新。

支付類型代碼

查看支援的支付代碼。

測試環境說明

使用 Sandbox 環境進行測試。