簡介
WAP（H5）支付允許商戶將用戶引導至手機瀏覽器（如 Chrome / Safari / Edge）開啟支付流程，並跳轉至對應電子錢包完成付款。 此方式適用於：- 行動網站（Mobile Web）
- App 內嵌瀏覽器
- 第三方瀏覽器啟動的支付流程
使用建議與限制
建議商戶引導用戶使用標準手機瀏覽器（如 Chrome／Safari）開啟支付流程。由於 WhatsApp、Facebook Messenger、WeChat 等社交 App 內嵌瀏覽器存在限制，QFPay 無法保證可正常喚起外部電子錢包 App。例如： 在 WeChat 內建瀏覽器中，可能無法自動跳轉至 Alipay App。
此屬於第三方 App 瀏覽器環境限制。
此屬於第三方 App 瀏覽器環境限制。
API 端點與方法
建立 WAP 支付交易
支付類型（PayType）
| PayType | 描述 |
|---|---|
800212 | 微信 H5 支付 |
801512 | 支付寶香港 WAP 支付 |
800712 | 銀聯 WAP 支付 |
805812 | PayMe WAP 支付 |
請求參數
| 參數名稱 | 參數編碼 | 必填 | 類型 | 說明 |
|---|---|---|---|---|
| 交易金額 | txamt | 是 | Int(11) | 最小幣值單位（如 100 = 1 元）。建議大於 200 以降低風控拒付機率。 |
| 交易貨幣 | txcurrcd | 是 | String(3) | 三位貨幣代碼。 |
| 支付類型 | pay_type | 是 | String(6) | 依選擇之電子錢包填入對應 PayType。 |
| 商戶訂單號 | out_trade_no | 是 | String(128) | Merchant Order Number，必須唯一。 |
| 交易時間 | txdtm | 是 | String(20) | 格式：YYYY-MM-DD hh:mm:ss |
| 商品名稱 | goods_name | 否 | String(64) | 最多 20 字元，不可含特殊符號。 |
| 商戶號 | mchid | 否 | String(16) | QFPay 分配之商戶識別碼。 |
| 裝置識別碼 | udid | 否 | String(40) | 商戶設備唯一識別碼。 |
| 前端返回網址 | return_url | 否 | String(255) | 付款完成後跳轉網址。 |
| 非同步通知網址 | notify_url | 否 | String(255) | 付款完成後接收通知的 Webhook URL。 |
回應參數
| 參數名稱 | 參數編碼 | 類型 | 說明 |
|---|---|---|---|
| 支付類型 | pay_type | String(6) | 對應電子錢包類型。 |
| 系統交易時間 | sysdtm | String(20) | 用於清算依據之時間戳。 |
| 商戶交易時間 | txdtm | String(20) | 商戶原始提交時間。 |
| 交易金額 | txamt | Int(11) | 最終交易金額。 |
| 外部訂單號 | out_trade_no | String(128) | Merchant Order Number。 |
| QFPay 訂單號 | syssn | String(40) | QFPay Transaction ID。 |
| 回應碼 | respcd | String(4) | 0000 = 成功建立交易；1143 / 1145 = 狀態未確定；其他請參閱狀態碼文件。 |
| 回應說明 | resperr | String(128) | 系統處理結果說明。 |
| 附加資訊 | respmsg | String(128) | 附加回傳訊息。 |
| 支付網址 | pay_url | String(512) | WAP 場景下需跳轉之支付 URL。 |
交易流程說明
- 商戶呼叫
/trade/v1/payment - 系統回傳
pay_url - 商戶將用戶導向該 URL
- 用戶於電子錢包頁面完成付款
- 系統透過非同步通知（Webhook）回傳最終交易結果
小結
- 適用於行動瀏覽器支付場景
- 需將用戶導向
pay_url - 建議實作 Webhook 與交易查詢 API
- 注意社交 App 內嵌瀏覽器限制