VibeFox Montonio for WooCommerce — 帮助
系统要求
WordPress：6.0 或更高版本。
WooCommerce：7.0 或更高版本，须已安装并启用。未安装 WooCommerce 时，插件无法启用。
PHP：8.0 或更高版本。
货币：店铺或订单货币必须为 EUR 或 PLN。对于其他任何货币，结账时会隐藏该付款方式。
Montonio 账户：您需要从 Montonio Partner System 获取店铺的访问密钥和私钥。沙盒和正式密钥不同，因此您使用的每个环境都需要一对密钥。除此之外，Montonio 无需其他设置：通知地址会随每笔付款一同发送。
公开网站：您的网站必须可从互联网访问，才能接收 Montonio 通知。否则，顾客返回店铺时，订单仍会被确认。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 wcp_montonio_payment 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Payments > Montonio > Manage，或在插件列表页面点击插件名称下的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 在 Montonio Partner System 中打开 Stores > your store > API keys，复制沙盒访问密钥和私钥。将它们粘贴到设置中，并保持 Sandbox mode 开启。
6. 开启 Enable/Disable，并在沙盒中测试一次付款。然后输入正式密钥，并取消勾选 Sandbox mode。
配置
所有设置都在一个页面中：WooCommerce > Settings > Payments > Montonio。页面在字段上方会在当前环境的密钥缺失时发出警告（此时结账时会隐藏该付款方式）、在店铺货币不是 EUR 或 PLN 时发出警告，并在沙盒开启时显示 Sandbox mode is on: payments are simulated and no real money is charged. 在付款方式列表中，Montonio 会被标记为需要设置，直到当前环境的两个密钥都已填写。
常规
Enable/Disable：Enable Montonio bank payments 用于开启或关闭该付款方式。默认：关闭。
Title：顾客在结账时看到的付款方式名称。默认：Bank payment (Montonio)。
Description：结账时显示在付款方式下方的文字。默认：Pay directly from your bank account. You will be redirected to Montonio to choose your bank.
API 密钥
请在 Montonio Partner System 的 Stores > your store > API keys 中获取密钥。沙盒和正式密钥不同。沙盒仅使用沙盒密钥，正式模式仅使用正式密钥。此设置部分还会显示通知 URL，格式类似于 https://your-site/wc-api/wc_mnt_payment/。您无需在任何地方输入它：插件会在每笔付款时将其发送给 Montonio。
Sandbox mode：Use the Montonio sandbox (test payments, no real money)。它会同时切换 Montonio API 地址和密钥对。默认：开启。仅在输入正式密钥之后才应关闭。
Sandbox access key：您的店铺在 Montonio 沙盒中的访问密钥（UUID）。
Sandbox secret key：您的店铺在 Montonio 沙盒中的私钥。
Live access key：您的店铺在 Montonio 正式环境中的访问密钥（UUID）。
Live secret key：您的店铺在 Montonio 正式环境中的私钥。
高级
Debug log：Log payment events 会将所有付款事件写入 WooCommerce > Status > Logs，来源为 wcp_montonio_payment。即使此选项关闭，错误仍会始终记录。密钥、令牌和顾客数据绝不会被记录。默认：关闭。
Delete data：Delete the gateway settings and logs when the plugin is deleted。停用插件从不会删除任何内容。订单数据（Montonio UUID、备注）始终保留。默认：关闭。
付款通知
Montonio 会通过带签名的令牌将每笔付款告知您的店铺。令牌以两种方式送达：通过发送到通知地址的服务器间通知，以及顾客返回店铺时随之送达。两者都会经过验证：使用您的私钥验证签名、检查有效期、核对您的访问密钥，并确认该付款是您的店铺在同一环境中为该订单创建的。未通过验证的令牌会被拒绝。每个状态只会应用一次，因此重复的通知不会添加备注、电子邮件或库存变动。
结账
顾客选择付款方式（默认为 Bank payment (Montonio)）并下单。插件会以订单货币为订单总额创建 Montonio 付款，并将顾客引导至 Montonio 付款页面。顾客在该页面选择银行并付款。顾客账单国家的银行优先显示（PLN 订单则为波兰）。付款会显示为 Order 加订单号。当店铺语言为德语、英语、爱沙尼亚语、芬兰语、立陶宛语、拉脱维亚语、波兰语或俄语时，Montonio 页面会以该语言打开，否则以英语打开。在沙盒模式下，结账时会在描述下方显示 SANDBOX MODE — test payment, no real money is charged.
只有当 Montonio 以 PAID 状态以及与订单完全一致的金额和币种确认后，订单才会标记为已付款。付款后，顾客会返回您店铺的订单已接收页面。在 Montonio 确认付款之前，该页面会显示 Montonio has not confirmed your payment yet. The order is updated as soon as the bank confirms it, and you will receive an e-mail then. 如果付款被取消或拒绝，顾客会返回 Pay for order 页面，并看到以下信息之一：The payment was cancelled or rejected by the bank. You can try again or choose another payment method.、The payment was not completed. You can try again or choose another payment method. 或 Montonio could not complete the payment. Please try again or choose another payment method.
顾客可以从 Pay for order 页面为未付款的订单重新付款。在创建新付款之前，插件会向 Montonio 查询之前的付款状态。如果之前的付款已完成，订单会被确认，且不会再创建第二笔付款。
如果 Montonio 无法发起付款，顾客会看到简短的提示，例如 Montonio is temporarily unavailable. Please try again in a few minutes or choose another payment method.，并可以选择其他付款方式。Montonio 的错误会添加到订单备注和日志中。
该付款方式适用于经典结账、结账区块和 Pay for order 页面。它兼容 WooCommerce 高性能订单存储（HPOS）。
本插件仅支持银行付款（付款发起）。不支持银行卡付款、BLIK、Apple Pay 或 Google Pay、先买后付或分期融资、Montonio 配送、订阅、已保存的付款方式，也不支持在您自己的网站上选择银行。
订单与退款
订单状态
待付款：顾客已被引导至 Montonio，但尚未付款。当 Montonio 将付款报告为待处理时，会添加一条备注。
处理中或已完成：Montonio 已确认付款（PAID）。订单遵循 WooCommerce 对已付款订单的标准状态。订单备注会显示银行、Montonio 付款 UUID、金额和环境。交易 ID 即 Montonio 付款 UUID。
保留：银行尚未确认付款（AUTHORIZED）；Montonio 报告 PAID 后，订单才会变为已付款。当 Montonio 报告的金额或币种与订单总额不同，当店铺处于正式模式时收到沙盒付款，或付款是在订单取消之后到达时，订单也会进入「保留」状态。订单备注会说明原因。请在 Montonio Partner System 中核实付款，然后发货或退款。
失败：顾客未完成付款，或银行拒绝了付款。只有未付款订单的最新一笔付款可以导致订单失败。顾客可以从 Pay for order 页面重试。
已付款、已取消或已退款的订单不会因后续通知而重新打开。如果已付款订单又收到第二笔付款，订单不会改变。备注会提示您在 Montonio Partner System 中退还第二笔付款。
退款
打开订单，点击 Refund，输入金额后点击 Refund via Bank payment (Montonio)（按钮使用付款方式名称）。对于通过 Montonio 付款的订单，支持全额和部分退款。退款会发送至付款所在的环境（沙盒或正式），因此该环境的密钥必须已设置。如果 Montonio 不接受退款，WooCommerce 会显示错误，且不会记录退款。已发送的退款会连同其状态和 Montonio 退款 ID 添加到订单备注中。
Montonio 之后会通过通知确认或拒绝每笔退款。确认结果会添加到订单备注中。如果 Montonio 拒绝退款，备注会说明款项未退还给顾客；请在 Montonio Partner System 中核实，并在 WooCommerce 中更正退款。
在 Montonio Partner System 中所做的退款，会在 Montonio 报告后添加到订单备注中。它们不会自动记录为 WooCommerce 退款。如有需要，请在 WooCommerce 中创建手动退款。
许可证密钥
本插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Payments > Montonio 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥不会释放该域名的名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，结账时不会向顾客显示 Montonio。即便仍有人开始付款，顾客也只会看到 This payment method is not available. Please choose another one. 已登录的店铺管理员仍能看到该付款方式，并带有 (unlicensed — visible to admins only) 标记，方便您在购买密钥前完成设置和测试。插件列表页面和 WooCommerce 页面会显示提醒。现有订单不受影响：已发起的付款仍会被确认，退款也可正常进行。
许可证到期后，插件仍可继续工作，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账时没有显示 Montonio：请检查许可证是否有效、Enable/Disable 是否开启、当前环境的两个密钥（沙盒模式下为 Sandbox access key 和 Sandbox secret key，正式模式下为 Live access key 和 Live secret key）是否都已填写，以及店铺或订单货币是否为 EUR 或 PLN。设置页面在密钥缺失或货币不受支持时会显示警告。
付款已完成，但订单仍为待付款：通知没有到达您的店铺。请检查网站是否可从互联网访问，以及设置中的密钥是否属于该付款所在的环境。顾客付款后返回店铺，或再次尝试支付同一订单时，订单也会被确认。
通知返回 Invalid token：令牌签名、有效期或访问密钥不匹配。请检查访问密钥和私钥是否复制正确、是否属于正确的环境，以及服务器时钟是否准确。
通知返回 Payment does not belong to this order 或 Wrong environment：该付款并非由本店铺为此订单创建，或是在另一环境（沙盒或正式）中创建的。当两个店铺使用同一 Montonio 账户和相同的订单号时，就会出现这种情况。
通知返回 Gateway not configured：尚未设置任何 Montonio 密钥。请输入密钥；Montonio 会重试该通知。
顾客下单时出现错误：请打开订单备注，或开启 Debug log，然后查看 WooCommerce > Status > Logs，来源为 wcp_montonio_payment。This payment method is temporarily unavailable. Please choose another payment method. 通常表示密钥错误或缺失。Montonio could not start the payment. Please check your order details or choose another payment method. 表示 Montonio 拒绝了付款数据；备注中有具体原因。
付款后订单处于保留状态：请阅读订单备注。银行尚未确认付款，已付金额或币种与订单不一致，正式模式下收到了沙盒付款，或付款是在订单取消之后到达的。请在 Montonio Partner System 中核实付款。
沙盒付款不会确认正式订单：当店铺处于正式模式时，沙盒付款绝不会完成订单；订单会改为保留状态。请将 Sandbox mode 切换到您想使用的环境，并使用该环境的密钥。
退款因环境相关的信息失败：付款是在沙盒或正式环境中进行的，而该环境的密钥尚未设置。请输入密钥后重试。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 为新域名激活密钥。如果无法连接许可证服务器，插件将沿用最后已知的状态继续运行。
卸载
停用插件会保留所有数据。如需删除，请在 Plugins 页面停用并删除插件。本插件的许可证密钥和许可证状态始终会被删除。只有在开启了 Delete data 的情况下，支付网关设置和日志才会被删除；否则会保留，以便日后重新安装。现有订单会保留其付款备注和交易 ID。
Montonio 是其各自所有者的商标。本插件与 Montonio 无关联，也未获得 Montonio 的认可。