跳轉到主要內容
本指南協助商戶在實體門市、餐廳、咖啡店、超市及其他面對面支付場景中,選擇適合的 QFPay 整合方式。 實際部署時,通常需要結合多個 QFPay API,而非僅使用單一整合方式。

適用場景

本整合方案適用於:
  • 餐廳
  • 咖啡店
  • 零售商店
  • 超市
  • 便利店
  • 服務型商戶
  • 其他面對面收款場景

典型架構

典型的商戶環境可能包含:
  • 收銀系統(POS/ECR)
  • QFPay POS 終端
  • 顧客點餐或付款 QR Code
  • 商戶後端系統,用於訂單管理及對帳

建議整合方式

範例方案

餐廳桌邊 QR Code 點餐

常見的餐廳場景中,顧客掃描桌上的 QR Code,瀏覽菜單、下單,並透過手機完成付款。
  1. 顧客掃描桌邊 QR Code。
  2. 開啟商戶的 H5 點餐頁面。
  3. 顧客完成點餐。
  4. 商戶後端透過 H5/WAP Payment API 建立付款訂單。
  5. 顧客完成付款。
  6. 商戶後端透過 非同步通知(Asynchronous Notifications) 接收付款結果。
  7. 如有需要,再透過 交易查詢(Transaction Enquiry 確認最終交易狀態。
  8. 更新訂單狀態並開始備餐。

最佳實踐

請務必使用 交易查詢(Transaction Enquiry) 作為付款確認的備援機制。雖然 非同步通知(Asynchronous Notifications) 應作為主要的付款結果通知方式,但網路異常或顧客中途中斷操作,可能導致通知延遲或未能即時送達。QFPay 建議:
  • 非同步通知 作為主要付款回調機制。
  • 當付款結果不明確時,使用 交易查詢 再次確認交易狀態。
  • 不要僅依賴瀏覽器跳轉或顧客操作判斷付款是否成功。
此做法可避免訂單停留於未知付款狀態,提升交易可靠性。
建議將付款處理、訂單履行及對帳流程分離,以提升系統可靠性,並簡化異常交易處理。

相關文件

POS API

整合收銀系統與 QFPay POS 終端。

ECR Integration

串接 ECR 系統與 QFPay POS 終端。

H5 支付

適用於桌邊點餐及手機付款等網頁支付場景。

商戶出示碼模式(正掃)(MPM)

產生動態 QR Code,供顧客使用電子錢包付款。

消費者出示碼模式(反掃)(CPM)

掃描顧客電子錢包條碼完成收款。

交易查詢

查詢交易狀態,確認付款結果。

非同步通知

接收 QFPay 即時付款通知。

下一步

確認適合您的整合方式後,即可前往對應的 API 文件開始開發與整合。