微信支付接入第一步:在商戶平台正確配置支付類型、授權目錄、回調地址。配置錯誤會導致「參數錯誤」、「無權限」等調試難題。本文梳理完整配置流程與避坑要點。
商戶平台 → 產品中心 → 開發配置 → 支付類型,建議**全部勾選**:
openid,適用於公眾號網頁、小程序、企業微信。原則:業務當前不需要的也建議勾選,避免後續上線新場景需重新審核(1-3 個工作日)。
設置支付發起頁面的域名與路徑,微信校驗 referer 或 origin 是否在授權範圍內。
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 並處理回調地址信息。| 配置項 | 說明 | 示例 | 備註 |
|---|---|---|---|
| JSAPI 支付授權目錄 | 網頁調起支付的頁面域名路徑 | https://www.example.com/wxpay/ | 與支付授權目錄通常一致 |
| Native 支付回調 URL | 掃碼支付結果通知地址 | https://api.example.com/pay/notify/native | 需外網可訪問、POST 接收 XML |
| APP 支付回調 URL | App 支付結果通知 | https://api.example.com/pay/notify/app | 同上 |
| H5 支付回調 URL | H5 支付結果通知 | https://api.example.com/pay/notify/h5 | 同上 |
| 退款通知 URL | 退款結果異步通知 | https://api.example.com/pay/notify/refund | 可選,建議配置 |