VibeFox PayPlug for WooCommerce — 帮助
系统要求
WordPress：6.0 或更高版本。
WooCommerce：7.0 或更高版本，且已安装并启用。未安装 WooCommerce 时，插件无法启用。
PHP：8.0 或更高版本。
币种和金额：欧元（EUR），每笔付款 0.99 至 20,000.00，即 PayPlug 的默认限制。使用其他币种或超出这些限制时，该付款方式会被隐藏。
PayPlug 账户：您需要 PayPlug 账户的密钥：测试密钥（sk_test_...）和/或正式密钥（sk_live_...）。无需其他密钥，也无需在 PayPlug 中设置任何通知。您的网站必须能从互联网访问才能接收通知；否则，顾客从 PayPlug 返回时订单才会更新。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 wcp_payplug_gateway 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Payments > PayPlug > Manage，或在插件列表页面点击插件名称下的 Settings。
4. 在页面顶部的许可证区域输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 从 PayPlug 后台粘贴您的密钥（参见配置）。
6. 开启 Enable/Disable 并保存。在开启 Test Mode 的情况下测试一笔付款，然后关闭它以接受真实付款。
配置
所有设置都位于同一页面：WooCommerce > Settings > Payments > PayPlug。当付款方式已启用，但当前模式的密钥为空时，或当店铺币种不是 EUR 时，页面会在字段上方显示警告。在这两种情况下，付款方式都会在结账页面隐藏。在付款方式列表中，测试模式下的 PayPlug 会显示测试模式标记；在当前模式设置密钥之前，它会被标记为需要设置。
结账
Enable/Disable：Enable PayPlug Gateway 用于开启或关闭该付款方式。默认：off。
Title：顾客在结账时看到的付款方式名称。默认：PayPlug。
Description：结账时显示在付款方式下方的文字。默认：Pay securely by card via PayPlug。
API 密钥
您可以在 PayPlug 后台的 Developers > API keys 中找到您的密钥。该部分还会显示插件随每笔付款发送的通知 URL，格式类似：https://your-site/wc-api/ppg_payplug_webhook/。在 PayPlug 中无需设置通知。
Test Mode：Enable test mode 会对新付款使用测试密钥。不会处理任何真实付款。在另一种模式下完成的付款，在状态检查和退款时仍会使用其自身模式的密钥。默认：on。
Test Secret Key：您的 PayPlug 测试密钥，以 sk_test_ 开头。
Live Secret Key：您的 PayPlug 正式密钥，以 sk_live_ 开头。
前缀错误的密钥不会被保存。页面会显示，例如：Test Secret Key 必须以 "sk_test_" 开头。已保留之前的值。
订单
Order Status After Payment：付款成功后设置的订单状态。状态会立即设置，无需第二次状态变更。
高级
Logging：Enable debug logging 会将 API 调用和通知记录在 WooCommerce > Status > Logs 中，来源为 wcp_payplug_gateway。错误始终会被记录。密钥、银行卡数据和顾客数据绝不会被记录。默认：off。
Delete Data on Uninstall：Remove all plugin data when uninstalling。勾选后，删除插件时会一并删除插件设置和日志。订单中保存的 PayPlug 付款 ID 会保留。默认：off。
结账
顾客选择付款方式（默认为 PayPlug）并下单。在测试模式下，结账页面会显示 测试模式：不会进行任何真实付款。 插件会按订单总额（以分为单位）在 PayPlug 中创建一笔付款，并将顾客引导至 PayPlug 付款页面。订单的账单和配送信息以及您网站的语言会传递给 PayPlug。顾客在那里使用银行卡付款。
付款后，顾客返回您的店铺。只有 PayPlug 确认后，订单才会被标记为已付款：插件会在收到通知时以及顾客返回时，通过 PayPlug API 读取付款信息。付款成功后，顾客会被引导至订单接收页面。
如果顾客在 PayPlug 页面取消，付款页面会在 PayPlug 中关闭，因此之后不会被误付。顾客会带着一条消息返回 Pay for order 页面，例如 您已取消 PayPlug 付款。您可以重试或选择其他付款方式。、PayPlug 付款会话已过期。请重试或选择其他付款方式。 或 PayPlug 付款失败。请重试或选择其他付款方式。
如果顾客再次支付同一笔订单，插件会先查看之前的尝试。如果该尝试期间已付款，则订单会在无需新付款的情况下完成。如果它仍对相同金额开放，则会复用同一付款页面。否则，旧页面会在 PayPlug 中关闭，并创建新的付款。
如果 PayPlug 无法发起付款，顾客会看到一条简短消息，例如 PayPlug 无法接受您的账单信息（邮政编码）。请检查后重试。 或 无法连接付款服务商。请稍后再试。 技术原因会添加到订单备注中。
该付款方式适用于经典结账、结账区块和 Pay for order 页面。它兼容 WooCommerce 高性能订单存储（HPOS）。
付款会立即扣款。本插件不支持 Oney 分期、Bancontact、Apple Pay 或 American Express，不支持一键保存卡片、嵌入式付款表单、订阅或延迟扣款。
订单与退款
Order statuses
Pending payment：顾客已被引导至 PayPlug，但尚未付款，或 PayPlug 尚未确认付款。
Processing or Completed：付款已确认。状态遵循 Order Status After Payment 的设置。订单备注会显示 PayPlug 付款及其模式。交易 ID 为 PayPlug 付款 ID（pay_...）。
On hold：已付金额或币种与订单不符（备注 amount/currency mismatch）；或店铺处于正式模式时进行了测试付款，因此没有收到任何款项；或付款到达时订单已被取消；或付款已授权但未扣款（请在 PayPlug 后台扣款；当 PayPlug 报告付款已完成时，订单会被标记为已付款）。订单备注会说明需要检查什么。
Failed：待付款订单的最近一次付款尝试失败或被取消。较早尝试的失败不会改变订单。顾客可以重新付款。
如果同一笔已付款订单的第二次尝试也付了款，订单不会发生变化。备注会提示您在 PayPlug 后台退还重复付款。
退款
打开订单，点击 Refund，输入金额，然后点击 Refund via PayPlug。支持全额和部分退款。退款会退至实际支付该订单的那笔付款，并使用其付款模式（测试或正式）的密钥，因此必须已设置该密钥。如果 PayPlug 不接受退款，WooCommerce 会显示错误，且不会记录任何退款。退款成功后，会将 PayPlug 退款 ID 添加到订单备注中。
在 PayPlug 后台进行的退款会通过通知到达，并添加到订单备注中。它们不会自动在 WooCommerce 中创建。如有需要，请手动记录。
许可证密钥
本插件需要使用从 vibefox.net 获取的 VibeFox 许可证密钥。许可证区域位于 WooCommerce > Settings > Payments > PayPlug 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区域会显示许可证状态，例如许可证有效期截止日期和您的域名。使用 Check now 可重新检查状态，使用 Change key 可输入其他密钥，使用 Remove key 可将密钥从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥并不会释放域名名额，请在您的 vibefox.net 账户中释放该名额。
没有有效的密钥时，结账页面不会向顾客显示 PayPlug。如果仍然发起了付款，顾客会看到 This payment method is not available. Please choose another one. 已登录的店铺管理员仍能看到该付款方式，并标有 (unlicensed — visible to admins only)，以便在购买密钥之前进行设置和测试。插件列表页面和 WooCommerce 页面会显示提醒。现有订单不受影响：已发起的付款仍会被确认，退款也可正常进行。
许可证过期后，插件仍可继续运行，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账页面中没有 PayPlug：请检查许可证是否有效，Enable/Disable 是否已开启，当前模式是否已设置密钥（测试模式下为 Test Secret Key，正式模式下为 Live Secret Key），店铺币种是否为 EUR，以及订单总额是否在 0.99 至 20,000.00 EUR 之间。使用其他限额的账户可以通过 ppg_amount_limits 过滤器修改（以分为单位的值）。
付款已完成，但订单仍为待付款：通知没有到达您的店铺，顾客也没有返回。请检查您的网站能否从互联网访问设置中显示的通知 URL，例如是否有维护模式、防火墙或密码保护阻止了访问。请在 WooCommerce > Status > Logs 中查看来源为 wcp_payplug_gateway 的记录，了解被拒绝的通知。
通知返回 Verification failed：无法从 PayPlug API 读取付款信息，例如 PayPlug 没有响应。订单不会变化，PayPlug 会再次发送通知。
通知返回 Busy, retry：订单在同一时间正被另一个请求更新，例如顾客返回。PayPlug 会再次发送通知。
通知返回 Unknown payment 或 Payment does not belong to the order：该付款不是由本店铺创建的，或不属于本订单，例如同一 PayPlug 账户上另一家店铺的付款。该通知会被忽略。
顾客看到 Payment could not be initiated：该订单之前的付款尝试正在确认中，或 PayPlug 拒绝了请求。请稍等片刻后重试；订单备注会显示 PayPlug 的错误信息。
付款后订单处于保留状态：请阅读订单备注。已付金额或币种与订单不符，店铺处于正式模式时进行了测试付款，或付款在订单被取消后到达。请处理订单或退还付款。
退款因模式相关信息而失败：付款是在测试或正式模式下完成的，而该模式的密钥未配置。请输入该密钥后重试。
许可证区域显示错误：请按照区域中的提示操作。例如，如果该密钥已在另一个域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，在新域名上激活该密钥。如果无法连接许可证服务器，插件将按最后一次已知的状态继续运行。
卸载
停用插件会保留所有数据。若要移除插件，请先停用，然后在 Plugins 页面中将其删除。本插件的许可证密钥和许可证状态始终会被删除。只有在 Delete Data on Uninstall 已开启时，网关设置和日志才会被删除；否则它们会保留，以便日后重新安装。现有订单会保留其付款备注、交易 ID 和 PayPlug 付款 ID。
PayPlug 是其各自所有者的商标。本插件与 PayPlug 无关，也未获得 PayPlug 的认可。