> ## 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 整合方式。

實際部署時，通常需要結合多個 QFPay API，而非僅使用單一整合方式。

***

## 適用場景

本整合方案適用於：

* 自動販賣機
* 自助服務機
* 智能櫃
* 售票機
* 停車繳費機
* 自助收銀設備
* 其他無人零售設備

***

## 典型架構

典型的自助零售環境可能包含：

* 顧客操作螢幕
* QR Code 掃描器（選配）
* 已連接或內建的 QFPay POS 終端
* 商戶後端系統，用於建立訂單及對帳

***

## 建議整合方式

| 支付方式                 | 建議整合                                                       | 說明                            |
| -------------------- | ---------------------------------------------------------- | ----------------------------- |
| 顧客掃描設備顯示的 QR Code 付款 | [商戶出示碼模式（正掃）（MPM）](/zh-hant/integration/in-store/MPM)      | 產生動態付款 QR Code，並顯示於設備畫面供顧客付款。 |
| 顧客使用銀行卡或八達通付款        | [POS API](/integration/in-store/pos-api/ecr)               | 透過 QFPay POS 終端完成銀行卡或八達通付款。   |
| 顧客出示電子錢包條碼供設備掃描      | [消費者出示碼模式（反掃）（CPM）](/zh-hant/integration/in-store/CPM)（選配） | 若設備具備條碼掃描器，可支援掃描顧客電子錢包條碼完成付款。 |

***

## 範例方案

### 自助設備付款流程

常見的自助零售場景中，顧客於設備上選購商品或服務，並自行完成付款。

1. 顧客於設備上選擇商品或服務。
2. 商戶後端建立訂單並計算付款金額。
3. 若使用電子錢包付款，呼叫 [**Merchant Present Mode (MPM)**](/zh-hant/integration/in-store/MPM) 產生動態付款 QR Code。
4. 若使用銀行卡或八達通付款，呼叫[POS API](/zh-hant/integration/in-store/pos-api/ecr)啟動 QFPay POS 終端收款。
5. 商戶後端透過 [**非同步通知（Asynchronous Notifications）**](/zh-hant/integration/common-api/async-notifications) 接收付款結果。
6. 如有需要，再透過 [**交易查詢（Transaction Enquiry）**](/zh-hant/integration/common-api/transaction-enquiry) 確認最終交易狀態。
7. 確認付款成功後，設備才發放商品或提供服務。

***

## 最佳實踐

<Warning>
  請務必在發放商品或提供服務前，確認交易已成功完成。

  QFPay 建議：

  * 以 **非同步通知（Asynchronous Notifications）** 作為主要付款結果通知方式。
  * 當付款結果不明確時，使用 **交易查詢（Transaction Enquiry）** 再次確認交易狀態。
  * 不要僅依賴設備畫面或顧客操作判斷付款是否成功。
  * 僅於交易確認成功後，才發放商品或提供服務。

  此做法可有效避免因網路異常、通知延遲或付款狀態不明而造成的商品損失。
</Warning>

<Tip>
  建議設備妥善處理付款失敗、交易逾時及網路中斷等情況，並向顧客清楚顯示目前狀態。同時，商戶後端應能追蹤及處理未完成的交易，以提升整體系統可靠性。
</Tip>

***

## 相關文件

<CardGroup cols={2}>
  <Card title="商戶出示碼模式（正掃）（MPM）" href="/zh-hant/integration/in-store/MPM">
    產生動態 QR Code，供顧客使用電子錢包付款。
  </Card>

  <Card title="POS API" href="/zh-hant/integration/in-store/pos-api">
    透過 QFPay POS 終端收取銀行卡及八達通付款。
  </Card>

  <Card title="消費者出示碼模式（反掃）（CPM）" href="/zh-hant/integration/in-store/CPM">
    掃描顧客電子錢包條碼完成付款。
  </Card>

  <Card title="ECR HTTPS 整合設定" href="/zh-hant/integration/in-store/pos-api/ecr-https">
    串接商戶系統與 QFPay POS 終端。
  </Card>

  <Card title="交易查詢" href="/zh-hant/integration/common-api/transaction-enquiry">
    查詢交易狀態，確認付款結果。
  </Card>

  <Card title="非同步通知" href="/zh-hant/integration/common-api/async-notifications">
    接收 QFPay 即時付款通知。
  </Card>
</CardGroup>

***

## 下一步

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