Skip to main content
Wechat Mp Process 微信小程式支付適用於 微信小程式(Mini Program)內部場景
商戶透過 QFPay API 建立交易後,將回傳的 pay_params 傳入 wx.requestPayment 以喚起微信支付模組。

整體流程

  1. 完成微信實名認證
  2. 透過小程式取得 openid
  3. 呼叫 /trade/v1/payment
  4. 取得 pay_params
  5. 呼叫 wx.requestPayment
  6. 透過 Webhook 或查詢 API 確認最終結果

Step 1:微信實名認證

商戶必須於微信官方平台完成身份驗證後,方可使用微信支付功能。 官方文件:
https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/login/auth.code2Session.html

Step 2:取得 openid

完成實名認證後,透過小程式登入流程取得使用者 openid 通常透過 wx.login() 取得 code,再呼叫微信後端 API 換取 openid

Step 3:建立交易

Endpoint

Create Mini Program Payment
PayType: 800213

Request Headers


請求參數

extend_info 範例

Real-name Example

Node.js 呼叫範例

Mini Program API Call Example

回應參數(重點)


pay_params 結構


Step 4:喚起支付模組

wx.requestPayment Example
respcd = 0000 僅代表交易建立成功。
最終支付結果必須透過:
  • Webhook 非同步通知
  • 交易查詢 API 確認。

微信小程式樣板

您可下載範例樣板快速開始: QFPay 微信小程式樣板

設定步驟

  1. 向 QFPay 註冊並綁定您的微信 AppID
  2. 登入 https://mp.weixin.qq.com
  3. 將以下網域加入 request 合法網域白名單:
Allowed Domain Example
  1. 將樣板專案部署至小程式開發環境
  2. 使用雲函式 getUserOpenID 取得 openid
  3. 呼叫支付 API

小結

  • 僅適用於微信小程式內部場景
  • 必須先取得 openid
  • API 成功僅代表交易建立
  • 最終狀態請依 Webhook 或查詢 API 為準