> ## 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.

# In-App 支付（原生 App 內支付）

> 本文件說明如何於 iOS / Android 原生 App 中整合電子錢包支付，包含常見 pay_type 與標準整合流程。

In-App 支付是指於 **原生 App（iOS / Android）** 內整合電子錢包支付能力，讓用戶在應用程式內完成付款流程，而不需跳轉至外部瀏覽器。

此模式可提供更流暢的使用體驗，並提升轉換率。

***

## 支援場景

適用於以下情境：

* 原生 App 內建購物或付款功能
* 透過電子錢包 SDK 呼叫支付模組（如微信、支付寶）
* 用戶於 App 內點選「付款」後，直接喚起電子錢包完成交易
* 支付完成後導回原 App 顯示結果頁

***

## 支援錢包與 pay\_type 對照

| pay\_type | 支付方式         | 說明                    |
| --------- | ------------ | --------------------- |
| `800210`  | 微信 In-App    | 使用微信 SDK 呼叫支付         |
| `801510`  | 支付寶香港 In-App | 透過 URL Scheme 或 SDK   |
| `805810`  | PayMe（香港）    | 透過 Deep Link 或 App 跳轉 |
| `800710`  | 銀聯雲閃付        | 使用雲閃付 SDK             |

<Note>
  各錢包開通條件不同，請確認是否需事前完成 App 支付權限申請（如微信 AppID、支付寶商戶 App ID 等）。
</Note>

***

## 常見整合方式

### 1️⃣ SDK 模式

* 商戶 App 整合錢包官方 SDK
* 呼叫 SDK API 發起支付
* 支付完成後由 SDK 回傳結果

適用於：

* 微信 In-App
* 雲閃付
* 部分支付寶場景

***

### 2️⃣ URL Scheme / Deep Link 模式

* 商戶產生包含付款資訊的跳轉連結
* 呼叫錢包 App
* 支付完成後透過 Scheme 導回原 App

適用於：

* 支付寶香港
* PayMe

***

### 3️⃣ 跳轉後返回原 App

支付完成後：

* 透過 redirect URL
* 或透過 App Scheme 回跳

請確保：

* 已設定正確的 Universal Link / App Scheme
* 正確處理回跳後的交易狀態顯示

***

## 通用 API 呼叫流程

大多數 In-App 支付皆使用以下 API：

§§§http 建立 In-App 支付交易 POST /trade/v1/payment §§§

流程說明：

1. 商戶 App 呼叫 `/trade/v1/payment`
2. 系統回傳 `pay_params` 或 `pay_url`
3. App 呼叫對應錢包 SDK 或跳轉至錢包 App
4. 用戶完成支付
5. QFPay 發送非同步通知（Webhook）
6. App 或後端確認最終交易狀態

***

## 重要注意事項

<Warning>
  `respcd = 0000` 僅代表交易建立成功。\
  最終交易結果必須透過 Webhook 或交易查詢 API 確認。
</Warning>

建議實作：

* Webhook 簽名驗證
* 交易查詢 API 補單機制
* App 端錯誤處理與重試機制

***

## 測試與驗證建議

* 測試跳轉與回跳流程是否正常
* 測試用戶在支付過程中關閉 App 的情境
* 測試網路中斷後的恢復機制
* 驗證訂單狀態同步是否一致

***

## 延伸閱讀

* 交易查詢 API
* 支付狀態碼對照表
* 各錢包支付整合文件
* Webhook 非同步通知說明

***

## 小結

* In-App 支付適用於原生 App 內整合電子錢包
* 支援 SDK 與 Deep Link 兩種模式
* 必須實作 Webhook 與查詢 API 保障交易狀態正確
* 建議完整測試跳轉與返回邏輯