> ## 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，而非僅使用單一整合方式。

## 適用場景

本整合方案適用於：

* 餐廳
* 咖啡店
* 零售商店
* 超市
* 便利店
* 服務型商戶
* 其他面對面收款場景

## 典型架構

典型的商戶環境可能包含：

* 收銀系統（POS／ECR）
* QFPay POS 終端
* 顧客點餐或付款 QR Code
* 商戶後端系統，用於訂單管理及對帳

## 建議整合方式

| 支付方式                    | 建議整合                                                                              | 說明                                                     |
| ----------------------- | --------------------------------------------------------------------------------- | ------------------------------------------------------ |
| 收銀員透過 POS 終端向顧客收款       | [POS API](/zh-hant/integration/in-store/pos-api/ecr)                              | 收銀系統將支付金額傳送至 QFPay POS 終端，顧客可使用銀行卡、電子錢包或其他支援的付款方式完成支付。 |
| 顧客掃描桌面 QR Code 並於手機完成付款 | [H5／WAP 支付](/zh-hant/integration/online-shop/integration-by-use-case/wap-payment) | 顧客透過手機網頁完成點餐及付款流程。                                     |
| 顧客掃描商戶展示的 QR Code 付款    | [商戶出示碼模式（正掃）（MPM）](/zh-hant/integration/in-store/MPM)                             | 產生動態付款 QR Code，供顧客使用電子錢包付款。                            |
| 商戶掃描顧客電子錢包條碼收款          | [消費者出示碼模式（反掃）（CPM）](/zh-hant/integration/in-store/CPM)                            | 掃描顧客電子錢包條碼完成付款。                                        |

## 範例方案

### 餐廳桌邊 QR Code 點餐

常見的餐廳場景中，顧客掃描桌上的 QR Code，瀏覽菜單、下單，並透過手機完成付款。

1. 顧客掃描桌邊 QR Code。
2. 開啟商戶的 H5 點餐頁面。
3. 顧客完成點餐。
4. 商戶後端透過 H5／WAP Payment API 建立付款訂單。
5. 顧客完成付款。
6. 商戶後端透過 [**非同步通知（Asynchronous Notifications）**](/zh-hant/integration/common-api/async-notifications) 接收付款結果。
7. 如有需要，再透過 **[交易查詢（Transaction Enquiry](/zh-hant/integration/common-api/transaction-enquiry)）** 確認最終交易狀態。
8. 更新訂單狀態並開始備餐。

## 最佳實踐

<Warning>
  請務必使用 [**交易查詢（Transaction Enquiry）**](/zh-hant/integration/common-api/transaction-enquiry) 作為付款確認的備援機制。

  雖然 [**非同步通知（Asynchronous Notifications）**](/zh-hant/integration/common-api/async-notifications) 應作為主要的付款結果通知方式，但網路異常或顧客中途中斷操作，可能導致通知延遲或未能即時送達。

  QFPay 建議：

  * 以 **非同步通知** 作為主要付款回調機制。
  * 當付款結果不明確時，使用 **交易查詢** 再次確認交易狀態。
  * 不要僅依賴瀏覽器跳轉或顧客操作判斷付款是否成功。

  此做法可避免訂單停留於未知付款狀態，提升交易可靠性。
</Warning>

<Tip>
  建議將付款處理、訂單履行及對帳流程分離，以提升系統可靠性，並簡化異常交易處理。
</Tip>

## 相關文件

<CardGroup cols={2}>
  <Card title="POS API" href="/zh-hant/integration/in-store/pos-api">
    整合收銀系統與 QFPay POS 終端。
  </Card>

  <Card title="ECR Integration" href="/zh-hant/integration/in-store/pos-api/ecr-https">
    串接 ECR 系統與 QFPay POS 終端。
  </Card>

  <Card title="H5 支付" href="/zh-hant/integration/online-shop/integration-by-use-case/wap-payment">
    適用於桌邊點餐及手機付款等網頁支付場景。
  </Card>

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

  <Card title="消費者出示碼模式（反掃）（CPM）" href="/zh-hant/integration/in-store/CPM">
    掃描顧客電子錢包條碼完成收款。
  </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 文件開始開發與整合。