跳轉到主要內容
本指南協助商戶在自助設備、販賣機、智能櫃、票務機及其他無人零售場景中,選擇適合的 QFPay 整合方式。 實際部署時,通常需要結合多個 QFPay API,而非僅使用單一整合方式。

適用場景

本整合方案適用於:
  • 自動販賣機
  • 自助服務機
  • 智能櫃
  • 售票機
  • 停車繳費機
  • 自助收銀設備
  • 其他無人零售設備

典型架構

典型的自助零售環境可能包含:
  • 顧客操作螢幕
  • QR Code 掃描器(選配)
  • 已連接或內建的 QFPay POS 終端
  • 商戶後端系統,用於建立訂單及對帳

建議整合方式


範例方案

自助設備付款流程

常見的自助零售場景中,顧客於設備上選購商品或服務,並自行完成付款。
  1. 顧客於設備上選擇商品或服務。
  2. 商戶後端建立訂單並計算付款金額。
  3. 若使用電子錢包付款,呼叫 Merchant Present Mode (MPM) 產生動態付款 QR Code。
  4. 若使用銀行卡或八達通付款,呼叫POS API啟動 QFPay POS 終端收款。
  5. 商戶後端透過 非同步通知(Asynchronous Notifications) 接收付款結果。
  6. 如有需要,再透過 交易查詢(Transaction Enquiry) 確認最終交易狀態。
  7. 確認付款成功後,設備才發放商品或提供服務。

最佳實踐

請務必在發放商品或提供服務前,確認交易已成功完成。QFPay 建議:
  • 非同步通知(Asynchronous Notifications) 作為主要付款結果通知方式。
  • 當付款結果不明確時,使用 交易查詢(Transaction Enquiry) 再次確認交易狀態。
  • 不要僅依賴設備畫面或顧客操作判斷付款是否成功。
  • 僅於交易確認成功後,才發放商品或提供服務。
此做法可有效避免因網路異常、通知延遲或付款狀態不明而造成的商品損失。
建議設備妥善處理付款失敗、交易逾時及網路中斷等情況,並向顧客清楚顯示目前狀態。同時,商戶後端應能追蹤及處理未完成的交易,以提升整體系統可靠性。

相關文件

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

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

POS API

透過 QFPay POS 終端收取銀行卡及八達通付款。

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

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

ECR HTTPS 整合設定

串接商戶系統與 QFPay POS 終端。

交易查詢

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

非同步通知

接收 QFPay 即時付款通知。

下一步

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