VibeFox PayPal for WooCommerce — 帮助
系统要求
WordPress：6.0 或更高版本。
WooCommerce：7.0 或更高版本，且已安装并启用。未安装 WooCommerce 时，插件无法启用。
PHP：8.0 或更高版本。
HTTPS：进行正式环境付款时，您的网站应使用 HTTPS。
PayPal 账户：一个 PayPal Business 账户，并在 PayPal Developer Dashboard 中创建了 REST API 应用。您需要该应用的 Client ID 和 Secret。沙盒应用与正式应用的凭据不同。无需设置 Webhook：插件会在顾客停留在结账页面时，于您的服务器上确认每一笔付款。
币种：PayPal 支持的币种之一：AUD、BRL、CAD、CHF、CNY、CZK、DKK、EUR、GBP、HKD、HUF、ILS、JPY、MXN、MYR、NOK、NZD、PHP、PLN、SEK、SGD、THB、TWD 或 USD。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 wcp_paypal_gateway 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 在 PayPal Developer Dashboard 中创建一个 REST API 应用（沙盒和/或正式），并复制其 Client ID 和 Secret。
4. 打开设置：WooCommerce > Settings > Payments > PayPal (Smart Buttons) > Manage，或在插件列表页面点击插件名称下的 Settings。
5. 在页面顶部的许可证区域输入您的 VibeFox 许可证密钥，然后点击 Activate。
6. 输入您所用模式的凭据，选择 Capture 或 Authorize，开启 Enable/Disable，然后保存。
7. 使用 PayPal 沙盒买家账户进行测试，然后取消勾选 Sandbox mode，并输入正式环境的凭据。
配置
所有设置都位于同一页面：WooCommerce > Settings > Payments > PayPal (Smart Buttons)。当付款方式已启用，但所选模式的 Client ID 或 Secret 为空时，或当 PayPal 不支持店铺币种时，页面会在字段上方显示警告。在这两种情况下，付款方式都会在结账页面隐藏。在付款方式列表中，沙盒模式下 PayPal 会显示 Test mode 标记；在填写所选模式的凭据之前，它会被标记为需要设置。
常规
Enable/Disable：Enable PayPal Gateway 用于开启或关闭该付款方式。默认：off。
Title：顾客在结账时看到的付款方式名称。默认：PayPal。
Description：结账时显示在付款方式下方的文字。默认：Pay with your PayPal account or a card via PayPal。
API 凭据
在 PayPal Developer Dashboard 中创建 REST API 应用，并复制其 Client ID 和 Secret。该部分提供沙盒应用和正式应用的链接。仅显示所选模式的字段。
Sandbox mode：Enable sandbox (test) mode。付款会使用沙盒凭据发送至 PayPal 沙盒，不会转移任何真实资金。默认：on。取消勾选即可接受真实付款。
Sandbox Client ID：您的沙盒 REST API 应用的 Client ID。
Sandbox Secret：您的沙盒 REST API 应用的 Secret。
Live Client ID：您的正式 REST API 应用的 Client ID。
Live Secret：您的正式 REST API 应用的 Secret。
付款
Payment action：顾客批准付款后执行的操作。默认：Capture。
高级
Debug log：Log API requests (errors are always logged)。日志条目保存在 WooCommerce > Status > Logs 中，来源为 wcp_paypal_gateway。凭据和买家数据绝不会被记录。默认：off。
Delete data on uninstall：Delete the gateway settings when the plugin is deleted。订单中的付款数据（订单中保存的 PayPal ID）始终保留。默认：off。
结账
当顾客选择 PayPal（默认名称为 PayPal）时，PayPal 按钮会取代 Place order。沙盒模式下，结账页面会显示 沙盒模式：请使用 PayPal 沙盒买家账户付款，不会扣除任何真实款项。 点击按钮后，您的服务器会按购物车总额（或 Pay for order 页面上的订单总额）创建一个 PayPal 订单。金额始终在服务器上计算，绝不在浏览器中计算。
顾客在 PayPal 窗口中使用 PayPal 账户或 PayPal 提供的其他资金来源批准付款。随后结账页面显示 PayPal 付款已批准，正在完成您的订单… 并提交订单。您的服务器会读取 PayPal 订单，检查其是否已批准、是否在本次结账中创建、是否未被其他订单使用，以及其金额和币种是否与订单一致。只有通过这些检查后，才会扣款（或授权），顾客随后进入订单接收页面。
如果购物车总额在批准后发生变化，则不会扣款。顾客会看到 您在 PayPal 中批准付款后，订单总额发生了变化。请再次点击 PayPal 按钮，批准新的总额。 如果结账字段缺失，批准结果会被保留：修正后，顾客点击 Place order 即可完成付款。如果 PayPal 拒绝付款，系统会提示顾客点击 PayPal 按钮并选择其他付款方式。如果顾客关闭了 PayPal 窗口，结账页面会显示 您已取消 PayPal 付款。
如果扣款期间 PayPal 没有响应，顾客会看到 我们暂时无法确认您的 PayPal 付款。请稍后再试，您不会被重复扣款。 重试时使用相同的批准；如果 PayPal 已完成之前的尝试，则会使用该笔付款，新的批准不会被扣款。
该付款方式适用于经典结账、结账区块以及 Pay for order 页面。PayPal 脚本在独立的命名空间中加载，因此不会与页面上的其他 PayPal 插件冲突。它兼容 WooCommerce 高性能订单存储（HPOS）。
本插件没有 PayPal Webhook，没有 Pay Later 提示信息、银行卡输入框、Venmo 设置、Apple Pay、Google Pay 或 Fastlane，不支持已保存的付款方式或订阅，商品页和购物车页也没有按钮。使用的是顾客在 WooCommerce 结账页面中输入的配送地址，而不是 PayPal 中的地址。
订单与退款
Order statuses
Pending payment：订单已创建，但付款尚未扣款，例如在收到 PayPal 的未知响应之后。
Processing：扣款已完成。仅包含可下载虚拟商品的订单会变为已完成，这是 WooCommerce 的默认设置。订单备注会显示金额、PayPal 订单和扣款信息。交易 ID 即 PayPal 扣款 ID，在订单页面中它会链接到您 PayPal 账户中的付款记录（沙盒或正式）。
On hold：付款已授权，等待扣款（付款操作 Authorize）；或 PayPal 中的扣款处于 PENDING 状态，例如付款审核中；或已付金额或币种与订单不一致；或无法从 PayPal 的响应中读取付款信息。订单备注会说明原因。
Failed：PayPal 拒绝了扣款或授权。
Cancelled：授权已通过 Void PayPal authorization 撤销。
订单操作
打开订单，在 Order actions 中选择一个操作，然后点击箭头。
退款
打开订单，点击 Refund，输入金额，然后点击 Refund via PayPal（按钮上会显示您的付款方式名称）。支持全额和部分退款。退款会发送至付款时所用的 PayPal 环境（沙盒或正式），因此必须已设置该环境的凭据。退款原因会作为给买家的备注传递给 PayPal。如果 PayPal 不接受退款，WooCommerce 会显示错误，且不会记录任何退款。退款成功后，PayPal 退款 ID 和状态会添加到订单备注中；处于 PENDING 状态的退款稍后会由 PayPal 完成。
仅授权的付款无法退款：请改用 Void PayPal authorization。您 PayPal 账户中进行的退款、争议和撤回不会同步到 WooCommerce。
许可证密钥
本插件需要使用从 vibefox.net 获取的 VibeFox 许可证密钥。许可证区域位于 WooCommerce > Settings > Payments > PayPal (Smart Buttons) 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区域会显示许可证状态，例如许可证有效期截止日期和您的域名。使用 Check now 可重新检查状态，使用 Change key 可输入其他密钥，使用 Remove key 可将密钥从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥并不会释放域名名额，请在您的 vibefox.net 账户中释放该名额。
没有有效的密钥时，结账页面不会向顾客显示 PayPal。如果仍然发起了付款，顾客会看到 This payment method is not available. Please choose another one. 已登录的店铺管理员仍能看到该付款方式，并标有 (unlicensed — visible to admins only)，以便在购买密钥之前进行设置和测试。插件列表页面和 WooCommerce 页面会显示提醒。现有订单不受影响：退款和订单操作仍可正常使用。
许可证过期后，插件仍可继续运行，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账页面中没有 PayPal：请检查许可证是否有效，Enable/Disable 是否已开启，所选模式的 Client ID 和 Secret 是否已填写，店铺币种是否受 PayPal 支持，以及购物车总额是否大于零。当凭据或币种有问题时，设置页面会显示警告。屏蔽 www.paypal.com 的浏览器扩展也会隐藏该按钮。
付款已完成，但订单仍为待付款：插件没有 Webhook，因此只有在结账期间才会确认付款。当 PayPal 在扣款期间没有响应时，会出现这种情况。请阅读订单备注，在您的 PayPal 账户中核对付款，并手动完成订单，或让顾客再次尝试：重试绝不会重复扣款。
PayPal 目前不可用：凭据有误，或属于另一种模式。请重新复制正确应用的 Client ID 和 Secret。
您的 PayPal 批准无法与本次结账匹配：PayPal 订单并非在本次结账会话中创建，例如会话过期之后。顾客需要再次点击 PayPal 按钮。
付款后订单处于保留状态：请阅读订单备注。付款已授权（请使用 Capture PayPal payment 扣款），扣款在 PayPal 中为 PENDING 状态（稍后请使用 Check PayPal payment status），或已付金额或币种与订单不符。
授权扣款失败：授权可能已超过 29 天，或已被撤销。订单备注会显示 PayPal 的错误信息。
退款失败：订单没有 PayPal 扣款（只有授权），或者付款时所用环境的凭据缺失。开发人员可以使用 wc_plg_supported_currencies 过滤器修改币种列表。
许可证区域显示错误：请按照区域中的提示操作。例如，如果该密钥已在另一个域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，在新域名上激活该密钥。如果无法连接许可证服务器，插件将按最后一次已知的状态继续运行。
卸载
停用插件会保留所有数据。若要移除插件，请先停用，然后在 Plugins 页面中将其删除。本插件的许可证密钥和许可证状态始终会被删除。只有在 Delete data on uninstall 已开启时，网关设置和缓存的 PayPal 访问令牌才会被删除；否则它们会保留，以便日后重新安装。现有订单会保留其付款备注、交易 ID 和 PayPal ID。
PayPal 是其各自所有者的商标。本插件与 PayPal 无关，也未获得 PayPal 的认可。