VibeFox Paysera for WooCommerce — 帮助
要求
WordPress：6.0 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。没有它，插件无法启用。
PHP：8.0 或更高版本。
Paysera 项目：您需要 Paysera 项目的项目 ID 和项目密码（签名密钥）。客户看到的付款方式即为此项目中启用的付款方式。在 Paysera 中无需为回调进行任何设置：每个付款请求都会附带回调 URL。
可访问的网站：订单通过 Paysera 回调付款，因此您的网站必须可以从互联网访问，不能位于登录页面、维护模式或防火墙之后。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 wcp_paysera_payment 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Payments > Paysera > Manage，或在插件页面中点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 输入您 Paysera 账户中的 Project ID 和 Project password（参见配置）。
6. 可选：在 Paysera 项目中启用 Allow test payments，并在插件中启用 Test payments，即可在不扣款的情况下测试流程。开始销售前请将其关闭。
7. 启用 Enable/Disable 并保存。
配置
所有设置都在同一页面中：WooCommerce > Settings > Payments > Paysera。在字段上方，只要缺少项目 ID 或项目密码中的任意一项，页面就会显示 在输入项目 ID 和项目密码之前，Paysera 在结账时处于隐藏状态。；同时，当测试付款或沙盒开启时，页面会提示不会向客户收费。在付款方式列表中，Paysera 会在项目配置完成前标记为需要设置；当测试付款或沙盒开启时，还会显示测试模式标记。
常规
Enable/Disable：Enable Paysera Payment 用于开启或关闭该付款方式。默认：关闭。
Title：结账时显示的付款方式名称。默认：Paysera。
Description：结账时付款方式下方显示的文字。默认：Pay securely via Paysera。
Paysera 项目
您可以在 Paysera 账户的 Projects and activities 中找到项目 ID 和项目密码：选择您的项目，然后进入 General project settings。该部分会显示回调 URL，其格式类似于 https://your-site/wc-api/wc_psr_payment/。每次付款时都会自动发送，无需在 Paysera 中进行任何设置。
Project ID：您的 Paysera 项目的数字 ID。
Project password：项目密码（签名密钥）。它用于为付款请求签名，并验证 Paysera 回调。
测试
Test payments：Send payments in test mode (no money is charged)。Paysera 会返回一笔成功的测试付款，而不会向客户收费。请先在 Paysera 项目设置中启用 Allow test payments。此选项开启时，测试付款会将订单标记为已付款；关闭时，测试付款永远不会为订单付款。默认：关闭。
Environment：客户被转到的目标环境。对于普通的 Paysera 项目，即使是测试付款，也应保持 Production。默认：Production。
高级
Debug log：Log payment events。错误始终会被记录。日志位于 WooCommerce > Status > Logs，来源为 wcp_paysera_payment。密码和客户数据从不写入日志。默认：关闭。
Delete data：Delete the plugin settings and logs when the plugin is deleted。停用插件不会删除任何内容。订单数据始终保留。默认：关闭。
结账
客户选择付款方式（默认为 Paysera）并提交订单。开启测试付款时，结账页面会显示 TEST MODE — no money will be charged.，即测试模式，不会扣除任何费用。插件会创建一个已签名的付款请求，其中包含以订单货币最小单位表示的订单总额、客户姓名、电子邮件和账单地址，并根据您网站的语言选择界面语言（立陶宛语、拉脱维亚语、爱沙尼亚语、俄语、德语、波兰语，其他情况下为英语）。客户会被转到 Paysera 付款窗口，并在那里选择银行、卡片或其他方式。
付款后，客户会返回订单接收页面。只有当已签名的 Paysera 回调到达时，订单才会被标记为已付款；客户的返回动作本身绝不会为订单付款。
如果客户在 Paysera 窗口中取消，订单将按照 WooCommerce 的标准方式取消，客户可以重新下单。如果无法发起付款，客户会看到 Paysera 付款暂时不可用。请选择其他付款方式。 原因会写入日志。
该付款方式支持经典结账、结账区块以及 Pay for order 页面。它与 WooCommerce 高性能订单存储（HPOS）兼容。
该插件不支持通过 WooCommerce 退款，结账页面不提供银行或付款方式选择，也不支持订阅、保存的卡片以及 Paysera 配送或快递服务。
订单
订单状态
Pending payment：客户已被转到 Paysera，但回调尚未到达。
Processing：Paysera 已确认付款（状态 1）。仅包含可下载虚拟商品的订单会变为“已完成”，这是 WooCommerce 的默认设置。订单备注会显示 Paysera 请求和付款方式。交易 ID 即为 Paysera 请求 ID。
On hold：Paysera 已接受付款指令但尚未执行（状态 2），Paysera 确认付款后订单才会完成；或者实际付款的金额或货币与订单不符（备注 amount/currency mismatch）；或者在测试付款关闭时收到了一笔测试付款，因此没有扣除任何费用。订单备注会说明原因。
Cancelled：客户在 Paysera 窗口中取消了付款，或者订单被您取消，或者库存保留超时而被取消。订单取消后再收到的付款不会改变其状态：备注会提示您恢复订单（将其设置为“处理中”）或在 Paysera 中退还该笔付款。
其他 Paysera 状态（付款未执行、需要补充信息）只会添加备注。如果已付款的订单又收到另一笔成功付款，订单不会改变，备注会提示您在 Paysera 账户中退还重复的付款。
退款
不支持通过 WooCommerce 退款：Paysera 付款窗口协议没有退款 API。请在您的 Paysera 账户中办理退款。当 Paysera 报告退款时，订单会添加一条包含退款金额的备注，订单状态保持不变。如有需要，请在 WooCommerce 中手动记录退款。
许可证密钥
本插件需要使用来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Payments > Paysera 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接可打开您的 vibefox.net 账户。
一个密钥仅适用于一个域名。从站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效的密钥时，Paysera 不会在结账时向客户显示。如果仍然发起了付款，客户会看到 This payment method is not available. Please choose another one. 已登录的商店管理人员仍会看到该付款方式，并标有 (unlicensed — visible to admins only)，方便您在购买密钥之前设置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响：已发起的付款仍会被确认。
许可证到期后，插件仍可正常运行，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账时没有显示 Paysera：请检查许可证是否有效，Enable/Disable 是否已开启，并确认已填写 Project ID 和 Project password。只要缺少其中任意一项，设置页面就会显示警告。
付款已完成，但订单仍为 Pending payment：订单是通过 Paysera 回调付款的，而不是通过客户返回来付款的。请检查您的网站能否通过设置中显示的回调 URL 从互联网访问（不在登录页、维护模式或防火墙之后），并查看 WooCommerce > Status > Logs，来源为 wcp_paysera_payment。
回调返回 Invalid signature：Project password 与项目不匹配，或回调并非来自 Paysera。请重新复制项目密码。
回调返回 Project ID mismatch：设置中的 Project ID 与完成付款的项目不同。
回调返回 Gateway not configured 或 Busy：项目 ID 或密码为空，或同一订单的另一个回调仍在处理中。Paysera 会重试回调。
Paysera 拒绝付款窗口或提示项目不存在：请检查 Environment。普通的 Paysera 项目只能使用 Production；Sandbox 需要在 Paysera 沙盒环境中创建的项目。
测试付款没有为订单付款：只有在 Test payments 开启时，测试付款才会为订单付款。否则订单会被置为保留状态，并附带备注说明没有扣除任何费用。同时请在 Paysera 项目中启用 Allow test payments。
结账时没有图标：插件默认不显示图标。开发人员可以使用 wc_psr_gateway_icon 过滤器设置图标。
订单处于 On hold 状态，且备注提示金额或货币不一致：Paysera 确认了一笔金额或货币与订单总额不符的付款，例如客户开始付款后订单被修改。请在您的 Paysera 账户中核对该付款，然后手动完成订单或退款。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在您的 vibefox.net 账户中释放名额并点击 Check now。如果站点地址已更改，请点击 Check now 以在新域名上激活密钥。如果无法连接许可证服务器，插件将按最后一次已知的状态继续运行。
卸载
停用插件会保留所有数据。要删除插件，请先在 Plugins 页面中停用，然后删除。本插件的许可证密钥和许可证状态始终会被删除。只有在开启了 Delete data 时，网关设置和日志才会被删除；否则会保留，以便日后重新安装。现有订单会保留其付款备注和交易 ID。
Paysera 是其各自所有者的商标。本插件与 Paysera 无关联，也未获得 Paysera 的认可。