WooCommerce支付网关配置：Stripe与PayPal完整接入指南

WooCommerceStripePayPal跨境电商支付配置

收款是第一优先级

跨境电商网站搭好了，产品也上架了，但客户就是无法付款——这是最让人崩溃的时刻。我自己在2025年帮一个朋友配置WooCommerce时，光支付网关的坑就踩了3天：Stripe显示"Invalid API key"但其实是webhook URL配置错了，PayPal的Sandbox模式和生产模式来回切换导致测试订单全部显示pending。

这篇文章说透一件事：WooCommerce接入Stripe和PayPal的完整流程，包括我踩过的真实踩坑记录。

---

为什么选Stripe + PayPal

全球跨境电商收款，Stripe和PayPal是最常见的组合：

Stripe的适用场景：

支持135+种货币，全球覆盖率最高
信用卡、借记卡、Apple Pay、Google Pay全部支持
API文档清晰，技术集成最容易
结算周期短（2天），资金周转快

PayPal的适用场景：

东南亚、欧洲大量用户习惯用PayPal余额支付
买家保护强，降低首次购买顾虑
新手用户信任度高（"我用PayPal更安全"）

推荐配置： Stripe为主（信用卡通道）+ PayPal为辅（覆盖PayPal用户），两个都开，不要只开一个。

---

前置条件

在开始配置前，确保你有：

1. WordPress + WooCommerce已安装（WooCommerce 8.0+，我测试用WooCommerce 10.7.0）

2. Stripe账号（stripe.com注册，无需月费，每笔2.9%+0.3USD手续费）

3. PayPal Business账号（paypal.com注册，需要企业认证）

4. SSL证书已配置（支付必须走HTTPS，Let's Encrypt免费证书即可）

---

第一步：安装官方支付插件

WooCommerce有官方支付网关插件，不需要装第三方：

# via WP-CLI安装（推荐）
wp plugin install woocommerce-gateway-stripe --activate
wp plugin install paypal-for-woocommerce --activate

或者后台：WooCommerce → 设置 → 付款 → Stripe/PayPal → 安装

我踩的坑：

> ⚠️ 不要同时安装多个Stripe插件（比如"Stripe for WooCommerce"第三方插件），会和官方插件冲突，导致付款时显示"Unexpected error"。保留官方woocommerce-gateway-stripe即可。

---

第二步：配置Stripe

获取Stripe API密钥

1. 登录 stripe.com/dashboard

2. 开发者 → API密钥

3. 复制测试模式密钥（pk_test_开头）和密钥密钥（sk_test_开头）

# 在Stripe Dashboard创建webhook endpoint
# 路径格式：https://yourdomain.com/?wc-api=wc_stripe

在WooCommerce中配置

WooCommerce → 设置 → 付款 → Stripe：

设置项	推荐值	说明
启用/停用	✅ 启用	开启Stripe
支付方式	信用卡+Apple Pay+Google Pay	按需勾选
模式	测试模式（先测试）	上线前切生产
Strip Live API密钥	sk_live_xxx	上线后填写
Strip Live Publishable密钥	pk_live_xxx	上线后填写
webhook签名密钥	whsec_xxx	验证支付真伪必填

我踩的坑：

> ⚠️ **webhook URL配置**：Stripe Dashboard → 开发者 → Webhooks → 添加endpoint。URL填 https://yourdomain.com/?wc-api=wc_stripe，事件选择 payment_intent.succeeded、charge.refunded、invoice.payment_failed。我第一次没选events，导致付款成功但订单状态还是pending。

> ⚠️ 测试模式切生产：上线前一定把WooCommerce设置里的"测试模式"关掉，并把pk_test/sk_test换成pk_live/sk_live。我有次忘记关测试模式，客户付款了但订单全部显示"等待中"——钱根本没到账。

---

第三步：配置PayPal

启用PayPal sandbox先测试

1. developer.paypal.com → 登录 → Dashboard

2. 创建Sandbox账号（模拟买家）

3. WooCommerce → 设置 → 付款 → PayPal → 启用

4. 勾选"启用PayPal沙盒"

# PayPal API凭据获取位置
# developer.paypal.com → Dashboard → My Apps & Credentials
# 选择"Sandbox"模式 → 创建App

在WooCommerce中填写

设置项	推荐值
PayPal Email	your-business@email.com
启用PayPal沙盒	✅ 先测试
付款场境	正式（上线后）
发票前缀	SHOP-（可选）
调试模式	✅ 开启（测试时）

我踩的坑：

> ⚠️ **PayPal sandbox账号问题**：在 sandbox.paypal.com 创建的账号，和 developer.paypal.com 的Sandbox账号是**两套独立的系统**。你在开发者后台创建的Sandbox账号用于API调用，但要在sandbox.paypal.com登录才能模拟买家付款操作。两者用户名可能不同。

> ⚠️ IP地址N/A：我遇到过一次PayPal报错"Instruction type not recognized"，原因是WooCommerce配置的PayPal接收邮箱和企业账号主体不一致。需要确保WooCommerce填的邮箱和你PayPal Business账号的邮箱是同一个。

---

第四步：测试完整支付流程

配置完成后，不要直接切换生产模式，先走一遍完整测试：

测试Stripe

# 使用Stripe测试卡号
# 成功：4242 4242 4242 4242 | 任意未来日期 | 任意3位CVC
# 失败：4000 0000 0000 0002（Declined）
# 3DS挑战：4000 0025 0000 3155

1. 结账页面选"信用卡"

2. 填入测试卡号

3. 完成后检查WooCommerce订单状态是否变为"已完成"

测试PayPal

1. 结账页面选"PayPal"

2. 点击"用PayPal付款"

3. 跳转到sandbox.paypal.com，用Sandbox账号登录

4. 确认付款

5. 返回网站，检查订单状态

验证Webhook触发

在Stripe Dashboard → 开发者 → Webhooks → 点击你的endpoint → 查看"最近事件列表"，确认payment_intent.succeeded被触发。如果Webhook没触发，订单状态不会自动更新。

---

第五步：切换生产模式

测试全部通过后：

1. Stripe：

- WooCommerce → Stripe设置 → 关闭"测试模式"

- 填入Live API密钥（sk_live/pk_live）

- webhook会自动切换到生产模式

2. PayPal：

- WooCommerce → PayPal设置 → 取消勾选"启用PayPal沙盒"

- 确认收款邮箱正确

3. 小金额测试：

用1元商品跑一次真实支付，确认资金到账Stripe/PayPal账户。

---

4个常见踩坑汇总

踩坑	原因	解决
Stripe显示Invalid API key	密钥填错或webhook签名未填	确认sk_test/sk_live对应关系，webhook签名必须填
付款成功但订单pending	webhook未触发或事件未选全	检查Stripe webhook事件列表，添加payment_intent.succeeded
PayPal报错N/A	WooCommerce邮箱和PayPal账号不一致	确保邮箱一致，或重新连接PayPal账号
测试模式切生产忘关	上线前没检查模式开关	养成习惯：每次上线前检查WooCommerce → Stripe/PayPal设置