WooCommerce Stripe插件配置？

学会这篇，你能独立完成 WooCommerce Stripe 插件的安装、密钥配置、Webhook 打通和一笔真实测试支付。

第一步：确认环境符合要求

这一步要确认服务器环境能跑得动插件，否则后面报错很难排查。进入 WordPress 后台 → 工具 → 站点健康 → 信息 → 服务器，检查：PHP 版本 7.4 以上、WooCommerce 版本 7.0 以上、WordPress 6.0 以上。最关键的是站点必须启用 HTTPS。

注意：没有 HTTPS 时，Stripe 的支付表单和 Apple Pay / Google Pay 按钮根本不会渲染出来，你会看到一片空白，而不是报错。

第二步：安装 WooCommerce Stripe 插件

这一步把官方插件装到站上。后台 → 插件 → 安装插件 → 右上角搜索框输入 WooCommerce Stripe，找到作者为 WooCommerce（Automattic）的「WooCommerce Stripe Payment Gateway」，点「立即安装」，安装完点「启用」。

注意：插件市场里有不少名字相似的第三方 Stripe 插件，认准发布者是 WooCommerce，别装错。

第三步：拿到 Stripe 的 API 密钥

这一步从 Stripe 官方后台取出两把钥匙。登录 dashboard.stripe.com → 左上角确认处于「测试模式」（Test mode 开关打开）→ 左侧菜单 开发者 → API 密钥。你会看到：

• 可发布密钥：pk_test_...
• 密钥：sk_test_...（点「显示」或「复制」）

两串都复制出来备用。

注意：sk_ 开头的密钥权限极高，不要贴进任何前端代码、截图或聊天记录。如果怀疑泄露，回这个页面点「滚动密钥」立即作废。

第四步：在 WooCommerce 后台填入密钥

这一步把密钥交给插件并开启支付方式。后台 → WooCommerce → 设置 → 付款 → 找到 Stripe，点右侧「管理」或「完成设置」。页面里填：

• 标题：结账页显示的支付名称，比如「信用卡支付」
• 描述：可留空
• 测试模式：先保持勾选
• 可发布密钥 / 密钥：粘贴第三步的两串 key
• 「保存更改」

回到付款列表页，确认 Stripe 右侧的开关已拨到「已启用」。

第五步：配置 Webhook

这一步让 Stripe 在支付成功后主动通知你的网站，订单状态才会自动从「待付款」变成「处理中」。插件较新版本会自动创建 Webhook；如果设置页提示需要手动添加，就去 Stripe 后台 → 开发者 → Webhook → 「添加端点」，端点 URL 填：

https://你的域名/?wc-api=wc_stripe

事件勾选 payment_intent.succeeded、charge.refunded、payment_intent.payment_failed，保存后复制「签名密钥」whsec_...，填回 WooCommerce 的 Stripe 设置页并保存。

注意：Webhook 收不到通常有两个原因——一是站点装了缓存插件或防火墙拦截了 ?wc-api= 这个回调地址，二是在 Stripe 里误删了端点。测试模式和生产模式的 Webhook 是两套，上线时要重建一次。

第六步：用测试卡跑一笔订单

这一步验证整条链路是否真的通。前台加一件商品 → 结账 → 选「信用卡支付」→ 卡号填 4242 4242 4242 4242，有效期填任意未来日期，CVC 填任意三位数，邮编随便填 → 下单。

成功后打开 WooCommerce → 订单，这笔订单状态应为「处理中」，点进去能看到 Stripe 交易号。再回 Stripe 后台 → 付款，也能看到这笔测试交易。

第七步：切换到正式模式上线

这一步开始收真钱。Stripe 后台关掉测试模式，重新复制 pk_live_... 和 sk_live_...；回 WooCommerce 的 Stripe 设置页，取消勾选「测试模式」，替换成 live 密钥，保存；再按第五步用 live 模式建一次 Webhook。最后用一张真实银行卡（哪怕小额）下一单，确认到账后把它退款。

注意：切换后务必先自己下一单验证。测试卡号在生产模式下会被直接拒绝。

小结

• 环境三要素：HTTPS、PHP 7.4+、WooCommerce 7.0+
• 密钥分测试（_test_）和生产（_live_）两套，不能混用
• Webhook 地址固定为 https://你的域名/?wc-api=wc_stripe
• sk_ 和 whsec_ 属于机密，不能外泄
• 上线前用 4242 4242 4242 4242 测通，上线后用小额真实订单再测一次