首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
您现在的位置: 程式碼之家 >> 編程語言 >  >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

微信支付開發入門(一):支付類型選擇與 URL 配置全流程指南

     編輯:PHP 相關知識

微信支付接入第一步:在商戶平台正確配置支付類型、授權目錄、回調地址。配置錯誤會導致「參數錯誤」、「無權限」等調試難題。本文梳理完整配置流程與避坑要點。

一、選擇支付類型

商戶平台 → 產品中心 → 開發配置 → 支付類型,建議**全部勾選**:

  • JSAPI 支付(公眾號/小程序):用戶在微信內網頁調起支付,需獲取 openid,適用於公眾號網頁、小程序、企業微信。
  • Native 支付(掃碼):生成二維碼,用戶掃碼支付,適用於 PC 網站、線下收銀、自助機。
  • APP 支付:原生 App 調起微信支付 SDK,需獨立申請移動應用權限。
  • H5 支付:微信外瀏覽器(手機瀏覽器)調起支付,無需公眾號綁定。
  • 小程序支付:小程序內調起支付,需綁定小程序 AppID。

原則:業務當前不需要的也建議勾選,避免後續上線新場景需重新審核(1-3 個工作日)。

二、支付授權目錄

設置支付發起頁面的域名與路徑,微信校驗 referer 或 origin 是否在授權範圍內。

配置規則

  • 協議:HTTP 或 HTTPS 均可。高安全要求業務(金融、醫療)強制 HTTPS。
  • 格式:http(s)://domain/path/,**必須以斜槠結尾**。
  • 示例:https://www.example.com/wxpay/
  • path 可以是不存在的虛擬目錄,僅作前綴匹配。

常見錯誤

錯誤寫法問題正確寫法
https://www.example.com/wxpay缺少結尾斜槠https://www.example.com/wxpay/
https://www.example.com根路徑過寬,安全風險https://www.example.com/pay/
https://localhost/wxpay/本地 IP/域名無法驗證使用內網穿透域名 https://dev.example.com/wxpay/

三、共享收貨地址

  • 選擇 「是」:允許用戶在支付時直接選擇微信存儲的收貨地址,提升轉化率。
  • 需在支付調用時傳入 need_address=1 並處理回調地址信息。

四、其他關鍵 URL 配置

五、開發調試避坑清單

  1. 域名備案:微信支付強制要求域名已 ICP 備案(港澳台/海外主體除外)。
  2. HTTPS 證書:回調 URL 必須 HTTPS,證書有效、鏈完整、支持 TLS 1.2+。
  3. 端口限制:回調 URL 僅支持 80/443 標準端口,非標準端口會驗證失敗。
  4. 測試賬號:申請通後,僅申請微信號可作測試,其他微信號調用會報「無權限」。開發期請用申請賬號調試。
  5. 沙箱環境:微信支付提供沙箱測試環境(https://api.mch.weixin.qq.com/sandboxnew/),簽名算法不同,專用測試證書,建議集成自動化測試。

六、配置生效時間

  • 支付類型、授權目錄:提交後**即時生效**(緩存可能延遲幾分鐘)。
  • 回調 URL:修改後即時生效,但舊訂單仍按舊 URL 通知。

下一篇預告:《微信支付開發(二):JSAPI 支付統一下單與前端調起完整流程》

配置無小事,每一項都關係到支付成功率。按表核對,一次配對,少踩坑。

  1. 上一篇文章:
  2. 下一篇文章:
Copyright © 程式碼之家 All Rights Reserved
配置項說明示例備註
JSAPI 支付授權目錄網頁調起支付的頁面域名路徑https://www.example.com/wxpay/與支付授權目錄通常一致
Native 支付回調 URL掃碼支付結果通知地址https://api.example.com/pay/notify/native需外網可訪問、POST 接收 XML
APP 支付回調 URLApp 支付結果通知https://api.example.com/pay/notify/app同上
H5 支付回調 URLH5 支付結果通知https://api.example.com/pay/notify/h5同上
退款通知 URL退款結果異步通知https://api.example.com/pay/notify/refund可選,建議配置