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

In-App 支付是指於 原生 App（iOS / Android） 內整合電子錢包支付能力，讓用戶在應用程式內完成付款流程，而不需跳轉至外部瀏覽器。 此模式可提供更流暢的使用體驗，並提升轉換率。

---

​

支援場景

適用於以下情境：

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

---

​

支援錢包與 pay_type 對照

---

​

常見整合方式

​

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 或後端確認最終交易狀態

---

​

重要注意事項

建議實作：

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

---

​

測試與驗證建議

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

---

​

延伸閱讀

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

---

​

小結

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