WooCommerce微信支付怎么接入？

学完这篇，你能在 WordPress + WooCommerce 站点上跑通微信支付（PC 扫码 + 微信内 JSAPI），下单能出二维码、付款后订单自动变成「处理中」。

第一步：先确认资质，决定走哪条路

微信支付不是装个插件就能用的，前置资质决定了你的方案：

• 有营业执照：直接申请微信支付普通商户号，走官方 API，费率 0.6% 左右，钱直接进自己账户。这是唯一推荐的正规路线。
• 没有营业执照：只能用虎皮椒、PayJS 这类聚合支付（第四方）间接接入，费率更高、资金经第三方周转，有跑路风险。

个人博客、跨境站别硬上，微信支付要求域名 ICP 备案。

注意：微信支付要求网站域名已备案 + 全站 HTTPS，且证书有效。用 IP 地址或未备案域名，后面回调一定失败。

第二步：在微信支付商户平台开通产品和取密钥

登录 pay.weixin.qq.com（微信支付商户平台），用超级管理员扫码进入，依次做三件事：

1. 开通产品：左侧「产品中心」→「支付产品」，开通「Native 支付」（PC 扫码）。如果还要在微信内置浏览器里付款，再开通「JSAPI 支付」，并绑定一个已认证的服务号 AppID（订阅号不行）。
2. 拿 APIv3 密钥：「账户中心」→「API 安全」→「APIv3 密钥」→ 点「设置 APIv3 密钥」，自己填一个 32 位字符串，记下来，只显示一次。
3. 下载证书：「账户中心」→「API 安全」→「API 证书」→「申请证书」，用微信提供的工具生成，拿到 apiclient_cert.pem 和 apiclient_key.pem 两个文件。

顺手记下三个值：商户号 mch_id（8～10 位数字）、AppID（公众号或小程序的）、APIv3 密钥。

第三步：安装微信支付插件

WooCommerce 本身不含微信支付。进入 WordPress 后台 →「插件」→「安装插件」→ 右上角搜索框输入「微信支付」或「WeChat Pay」，选一个近 6 个月内有更新、安装量较高的插件，点「立即安装」再点「启用」。

用聚合支付的，去服务商官网下载对应的 WooCommerce 插件 zip，然后「插件」→「安装插件」→「上传插件」→「选择文件」→「现在安装」。

注意：插件装完先别急着填参数。去「WooCommerce」→「设置」→「常规」，把「货币」改成「人民币（¥）」，否则微信支付接口会因金额币种不符直接拒单。

第四步：填写参数、配置回调

进入「WooCommerce」→「设置」→「付款」（WooCommerce 9.x 里叫「付款」，8.x 及更早叫「结账」），找到「微信支付」一行，点右侧「管理」（或「完成设置」）：

• 填入 AppID、商户号、APIv3 密钥
• 上传上一步下载的两个 .pem 证书文件
• 支付方式勾选「Native 支付」（PC）和「JSAPI 支付」（微信内），JSAPI 需要再填公众号 AppSecret
• 回调地址一般插件会自动填好，形如 https://你的域名/?wc-api=wc_wechatpay_callback，复制它

回到微信支付商户平台，「产品中心」→「开发配置」→「JSAPI 支付授权目录」填 https://你的域名/（含结尾斜杠），保存。

注意：服务器时间必须和标准时间一致，偏差超过 5 分钟，APIv3 签名会全部失败。用 date 命令检查，装个 NTP 同步即可。

第五步：下单测试

前台加一件商品 → 结算 → 选「微信支付」→ 下单，PC 端应出现二维码，手机微信扫码付款。付款成功后回到「WooCommerce」→「订单」，该订单状态应自动从「待付款」变为「处理中」。

微信内打开同一页面，应直接唤起付款界面而不是二维码。

测不通时按顺序排查：域名是否备案、HTTPS 是否有效、回调 URL 能否被外网 POST 访问（很多 WAF/CDN 会拦）、证书是否传对、货币是否 CNY。

小结

• 微信支付必须备案域名 + HTTPS，没营业执照只能走聚合支付，风险自负
• 商户平台要做三件事：开产品、设 APIv3 密钥、下载 API 证书
• WooCommerce 侧要先改货币为人民币，再填 AppID / 商户号 / 密钥 / 证书
• JSAPI 支付授权目录必须和站点域名完全一致，别漏结尾斜杠
• 服务器时间不同步是签名失败的头号原因