WooCommerce 支付网关配置：PayPal 与 Stripe（图文教程）

一、在哪管理支付网关

所有支付方式集中在 WooCommerce → 设置 → 付款 页面。这里列出已安装的网关，每个卡片右侧有开关和 Manage 按钮。

新安装的 WooCommerce 默认提供一些基础选项（货到付款、银行转账、支票等），但 PayPal 和 Stripe 需要单独安装插件才会出现。

---

二、PayPal Payments：官方推荐的 PayPal 方案

PayPal Payments 是 WooCommerce 官方维护的 PayPal 集成插件，取代了旧的 PayPal Standard。它不仅支持 PayPal 余额支付，还支持信用卡、Pay Later（先买后付）、Venmo（美国），以及 Apple Pay 和 Google Pay。

🛒 2.1 安装插件

进入 插件 → 安装新插件，搜索 WooCommerce PayPal Payments，点击 Install Now，安装完成后点 Activate。

激活后，WooCommerce → 设置 → 付款 页面会出现 PayPal 的卡片。

🔗 2.2 连接 PayPal 账户

点击 PayPal 卡片上的 Manage，进入设置页。页面上有一个醒目的 Activate PayPal Payments 按钮，点击后会跳转到 PayPal 登录页，授权 WooCommerce 连接你的 PayPal 商业账户。完成授权后自动跳回后台，连接状态显示”已连接”即为成功。

⚠️ 必须使用 PayPal 商业账户（Business Account）。个人账户无法接收商业付款。如果你的 PayPal 还是个人账户，在 PayPal 后台免费升级为商业账户。

🧪 2.3 沙盒测试环境

在上线前先测试。在 PayPal Payments 设置页点击 See advanced options，勾选 Sandbox Mode，然后点击 Connect Account 连接你的 PayPal Sandbox 测试账户。

如果你还没有 Sandbox 账户：

1. 访问 developer.paypal.com，用你的 PayPal 账号登录
2. 进入 Dashboard → Sandbox Accounts → Create Account
3. 创建一个 Business 类型账户（用作商户）和一个 Personal 类型账户（用作买家）
4. 记下两个账户的邮箱和密码，测试时买家账户用来付款，商户账户用来收款

💡 沙盒模式下所有交易都是模拟的，不会产生真实资金流动。上线前务必回到设置页关掉 Sandbox Mode，否则客户付的钱不会到你的真账户。

⚙️ 2.4 关键设置

在 PayPal Payments 设置页，几个值得关注的选项：

• Invoice Prefix：发票号前缀，建议填一个简短标识（如 INV-），方便对账

• Order Intent：选 Capture（立即扣款）还是 Authorize（先授权、后手动扣款）。绝大多数店铺选 Capture

• Save Payment Methods：允许客户保存 PayPal 账户或信用卡用于下次购买

⚠️ PayPal Payments 官方文档目前标记为”仍在开发中”（still under development），配置界面和选项可能随版本变化。以你后台实际看到的界面为准。

---

三、Stripe：信用卡支付的主力

Stripe 是跨境独立站最常用的信用卡收单方案，支持 Visa、MasterCard、American Express、Discover 等主流卡种，以及 SEPA（欧洲）、iDEAL（荷兰）等本地支付方式。

📥 3.1 安装插件

进入 插件 → 安装新插件，搜索 WooCommerce Stripe Gateway，安装并激活。

🔐 3.2 连接 Stripe 账户

Stripe 现在使用 OAuth 连接，不再需要手动粘贴 API Key。

进入 WooCommerce → 设置 → 付款 → Stripe → Manage → Settings，点击 Configure connection 按钮，在弹窗中登录你的 Stripe 账户并授权。连接成功后，Account details 区域会显示你的 Stripe 商户 ID 和 Webhook 状态。

⚠️ 如果你是很早之前用的手动 API Key 方式连接的 Stripe，官方的要求是在 2025 年 10 月 20 日之前重新认证为 OAuth 连接。旧的 API Key 连接方式存在安全风险，且不再接收功能更新。去 Stripe 设置页点 Re-authenticate 即可完成迁移。

💳 3.3 支持的支付方式

Stripe 设置页有一个 Payment Methods 标签，列出了所有可用的支付方式。勾选你要启用的即可：

• Credit / Debit Cards：信用卡和借记卡，必开

• Apple Pay / Google Pay：快捷支付按钮，强烈建议开。注意两者是联动的——勾选一个会自动启用另一个，不能单独控制

• Link by Stripe：Stripe 的快速结账工具，客户首次支付后自动保存信息，下次一键完成

• SEPA Direct Debit：欧洲银行直接扣款

• Klarna / Afterpay：先买后付（分期）

勾选后拉到页面底部保存。启用的方式会自动出现在结账页。

---

四、测试模式：先跑通再上线

两个网关都有测试模式，上线前务必跑一遍完整支付流程。

🧫 4.1 Stripe 测试模式

进入 WooCommerce → 设置 → 付款 → Stripe → Settings，在 General 区域勾选 Enable test mode，保存。

测试信用卡号：4242 4242 4242 4242，过期日期任意未来日期，CVC 任意 3 位数字。这是 Stripe 官方的成功测试卡号，测试模式下不会被实际扣款。

还有几个特殊测试卡号：

• 4000 0000 0000 0002：模拟支付被拒绝（decline）

• 4000 0025 0000 3155：模拟需要 3D Secure 验证，完成验证后支付成功

• 4000 0000 0000 3220：同样强制 3D Secure 验证，验证后支付成功（适合回归测试 3DS 流程）

• 4000 0084 0000 1629：模拟 3D Secure 验证完成后支付仍被拒绝（card_declined）

测试完成后，关闭 Enable test mode 保存。

🏦 4.2 PayPal 沙盒测试

前面 2.3 已经讲了 Sandbox 的创建和连接。补充一点：用买家 Sandbox 账户在前端完成支付后，去 sandbox.paypal.com 用商户 Sandbox 账户登录，能在交易记录里看到这笔测试订单。

⚠️ 4.3 测试模式的常见错误

最容易犯的错：站点上线后忘记关测试模式。Stripe 测试模式下客户会看到 “Test Mode” 标记，但 PayPal Sandbox 连通的是沙盒环境，真实客户根本无法支付——他们会看到支付失败或奇怪的错误提示。

⚠️ 上线检查清单：Stripe 关掉 Enable test mode → 确认 Account details 显示 Live 模式已连接 → PayPal Payments 关掉 Sandbox Mode → 用你自己的真卡走一遍完整支付 → 检查 Stripe/PayPal 后台是否收到了这笔钱。

---

五、Apple Pay 和 Google Pay

这两种快速支付方式能让客户跳过手动填卡号的步骤，一键完成支付，对移动端转化率提升明显。

🍎 5.1 开启方式

在 Stripe 里：WooCommerce → 设置 → 付款 → Stripe → Payment Methods 标签 → Express checkouts 区域 → 勾选 Apple Pay / Google Pay → 保存。

在 PayPal Payments 里：连接 PayPal 账户后自动包含，不需要额外设置。

📱 5.2 设备和浏览器要求

它们不是在所有设备上都显示。规则如下：

• Apple Pay：仅 Safari 浏览器 + macOS 或 iOS 设备 + 用户在 Apple Wallet 中已添加卡片

• Google Pay：Chrome 浏览器 + 用户在 Google 账户中已保存支付方式

Windows 系统的 Chrome 用户能看到 Google Pay 但看不到 Apple Pay。Android 用户反之。两者互不冲突，各出现各的。

🔧 5.3 前置条件

• 网站必须开启 HTTPS（SSL 证书）。HTTP 站点上这两个按钮不会出现

• Stripe 会自动完成域名验证。如果 Apple Pay 不显示，去 Stripe 设置页确认 Payment Methods 标签里没有红色错误提示

• PayPal Payments 的 Apple Pay 需要额外域名注册，设置页 Overview 区域会有 Register Domain for Apple Pay 提示，点击完成即可

💡 如果你的产品是不需要配送的虚拟商品，且定价不含税 + 按客户账单地址算税，Apple Pay 和 Google Pay 按钮会被自动隐藏——因为系统在结账页加载时还不知道账单地址，无法计算税。这个不是 bug，是逻辑限制。

---

六、收款货币设置

收款币种在 WooCommerce → 设置 → 常规 页的 Currency 字段设置。这个设置影响所有支付网关的结算货币。

几个要点：

• PayPal 收到的钱就是这个币种，如果你的 PayPal 账户的默认币种不是这个，PayPal 会自动兑换并收取汇兑费

• Stripe 支持多币种收款，但需要你的 Stripe 账户开通对应币种的处理能力。在 Stripe Dashboard → Settings → Payments 里可以看到已激活的币种

• 如果主币种是美元（USD），但客户用欧元卡支付，Stripe 会在客户端展示欧元金额，然后按 Stripe 的汇率兑换成美元打到你的账户。汇率在 Stripe 交易记录里可查

💡 跨境独立站最常用的组合：主币种 USD + Stripe 处理所有卡支付 + PayPal 兜底。如果主要市场在欧洲，可以考虑 EUR；在澳大利亚则用 AUD。选好币种后不要随意改，已有的订单和价格不会自动转换。

---

七、支付失败排查

🧩 7.1 结账页点支付没反应、页面刷新或白屏

八成是 JavaScript 冲突。打开浏览器开发者工具（F12 → Console），看有没有红色报错。常见原因：

• 缓存插件把 Stripe/PayPal 的 JS 文件合并或延迟加载了，导致支付表单没初始化。把支付相关脚本加入缓存插件的排除列表

• 主题或另一个插件加载了旧版 jQuery 或冲突的 JS 库

• 排查方法：暂时切换到默认主题（Storefront），逐一禁用其他插件，找到冲突源

🔑 7.2 Stripe 支付提示 “Invalid API Key” 或 “No such token”

如果你用的是手动 API Key（老版本连接方式），检查是否把测试密钥（sk_test_ / pk_test_ 开头）填到了正式环境，或反过来。新 OAuth 连接方式不会出现这个错误。

🔄 7.3 PayPal 付款成功但订单卡在 Pending

先分清你用的是哪个 PayPal 插件：

• PayPal Payments（本篇推荐的新插件）：订单状态通过 Webhook 自动同步，不需要手动配置。订单卡在 Pending 时，进入 PayPal Payments 设置页检查 Webhook 连接状态，必要时断开账户重新连接，插件会自动重建 Webhook

• 旧 PayPal Standard（已淘汰，仅遗留店铺）：靠 IPN（即时付款通知）同步状态。如果你的店还在跑旧网关，在 PayPal 后台 Settings → Notifications → Instant Payment Notifications 里确认 IPN 已启用、URL 可正常访问（非 404）。这类店铺请尽快按本篇开头的说明迁移到 PayPal Payments

💸 7.4 客户说付了钱但 WooCommerce 里订单还是 Pending payment

• 检查是不是测试模式没关。Stripe 测试模式的订单永远不会有真实资金入账

• 检查 Webhook 状态。Stripe 设置页 Account details 区域看 Webhook 是不是 Enabled。如果 Disabled，点 Configure webhooks 重新建立

• 如果是 PayPal，按 7.3 的思路检查 Webhook（新插件）或 IPN（旧网关）

🍏 7.5 Apple Pay 按钮不出现

按顺序排查：SSL 证书是否有效 → Safari 浏览器是否最新 → 设备是否为 macOS/iOS → Apple Wallet 是否有已添加的卡 → 如果是虚拟商品且不含税定价，参考 5.3 的逻辑限制 → 去 Stripe Payment Methods 页确认 Apple Pay 已勾选