Skip to main content

產品說明

微信掃碼支付允許顧客使用 微信 App 的「掃一掃」功能,掃描商戶系統產生的 付款 QR Code 完成付款。 常見使用場景:
  • 桌面網站付款(顯示 QR Code 讓顧客掃碼)
  • POS / 收銀台螢幕顯示 QR Code
  • Kiosk / 自助機付款

何時使用

當您的收款流程是「商戶顯示 QR Code → 顧客用微信掃碼 → 完成支付」時,使用本支付方式。

API 端點與方法

建立微信掃碼支付交易
PayType: 800201

請求標頭


請求參數


實名認證(選用)

商戶可選擇啟用 微信實名認證(Real-name Verification)。
目前實名認證僅適用於 中國大陸公民,需提供:
  • 付款人真實姓名
  • 中國居民身分證號碼
規則說明:
  • 若商戶已提供身份資訊,付款人微信錢包(如綁定銀行卡)需與提供資料一致
  • 若付款人尚未綁定銀行卡,仍可完成付款
  • 是否強制實名,依商戶開通設定為準

extend_info 範例

Real-name Verification Example

請求範例

WeChat QR Payment Request

回應參數

respcd = 0000 僅代表交易建立成功。
商戶需展示 qrcode 給顧客掃碼,付款完成後的最終狀態請以 Webhook 或查詢 API 確認。

回應範例

WeChat QR Payment Response

範例程式碼(多語言)

以下範例邏輯一致,僅語言不同。
請依您的實際開發語言選擇對應範例。

整合注意事項與最佳實務

商戶需將回傳的 qrcode 內容轉換成 QR Code 圖像(例如 Canvas / QR Library),並展示給顧客掃描。
當回傳碼為 11431145 時,代表交易狀態未確定。
商戶必須主動透過交易查詢 API 確認最終狀態,並在必要時進行補單處理。
建議保存以下欄位以利對帳與補單:
  • syssn(QFPay Transaction ID)
  • out_trade_no(Merchant Order Number)

小結

  • 適合「顯示 QR Code → 顧客掃碼付款」的收款場景
  • 商戶需自行生成並展示 QR Code 圖像
  • 可選擇啟用實名認證(僅限中國大陸)
  • 建議實作 Webhook / 查詢 API 以確保交易狀態一致