1. 取得支付參數
API 端點:/trade/v1/payment請求方法:
POST支付編碼(pay_type):
802010
請求參數
| 參數名稱 | 是否必填 | 類型 | 描述 |
|---|---|---|---|
| 通用請求參數 | 是 | 依照平台設定 | 詳見 通用請求參數 |
回應參數
| 參數名稱 | 類型 | 描述 |
|---|---|---|
| 通用回應參數 | 依照平台設定 | 詳見 通用回應參數 |
pay_params | String(128) | 用於拉起銀行 FPS 支付應用的 URL,例如:https://fps.xxx/xxx |
2. Android FPS 支付流程
2.1 原生 App-to-App 流程
- 商戶先透過 API 取得
pay_params(URL) - 透過 Android
Intent啟動 FPS 支付 App - 設定 Action:
hk.com.hkicl,並以 keyurl傳入支付 URL - 使用
startActivityForResult連動支付 App - 在
onActivityResult接收支付結果 - 商戶 App 應以自身訂單狀態(建議查詢 API / 後端訂單狀態)確認最終結果

Java
2.2 Android H5-to-App 支付流程
H5 頁面可透過 WebView 調用 FPS App 完成支付,需實作以下幾步:- WebView 設定
- 啟用 JavaScript:
webView.getSettings().setJavaScriptEnabled(true) - 綁定 JS 與 Android 溝通橋接:
addJavascriptInterface(new JsBridge(), "AndroidBridge")
- 啟用 JavaScript:
- H5 觸發支付
- 用戶點擊付款後,H5 以 JS 呼叫 Android:
AndroidBridge.handleMessage(JSON.stringify({ url: 'https://fps.qfapi.com/xxx' }))
- 用戶點擊付款後,H5 以 JS 呼叫 Android:
- 原生 App 接收參數並拉起支付 App
- 組裝
Intent發送支付請求
- 組裝
- 接收結果並回傳給 H5
- 在
onActivityResult()內使用 JS 回傳 WebView
- 在
- 商戶應以自身訂單查詢為準確認最終支付狀態
Java
3. iOS App-to-App 支付流程
3.1 原生 App 啟動 FPS 支付 App
- 商戶先調用支付參數接口,獲取支付參數 URL(
pay_params) - 商戶 App 使用 iOS App Extension 框架 +
UIActivityViewController調起支援的支付 App(如銀行 App) - 消費者在支付 App 完成付款後,透過回調參數
callback(即商戶 App 的 Universal Link)跳轉回商戶 App - 商戶 App 必須根據自身訂單狀態確認最終支付結果
3.2 iOS H5-to-App 雙向通信支付流程
H5 調用原生 App 的核心在於建立雙向通信機制,完成支付參數的傳遞與結果回傳:- H5 調用後端接口獲得支付參數
- 使用 JsBridge 將支付參數傳遞給原生 App
- App 接收到後呼叫 FPS App 進行支付(同 3.1 流程)
- 支付完成後 App 將結果透過
evaluateJavaScript回傳給 H5 顯示 - 使用
WKWebView+ JSBridge 實現
下載範例 Demo
- Android 原生 App-to-App 示範:FPS H5 Demo
- Android H5-to-App 示範:FPS H5 Demo
- Objective-C 示範:FPS Objective-C Demo
- Swift 示範:FPS Swift Demo
- JSBridge 示範:fps-jsBridge Demo
