VibeFox MultiSafepay for WooCommerce — 帮助
系统要求
WordPress：6.0 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。没有 WooCommerce 时插件无法激活。
PHP：8.0 或更高版本。
货币：店铺或订单的货币必须是 MultiSafepay 接受的货币，例如 EUR、USD、GBP、PLN、CHF、SEK、DKK 或 NOK。对于其他货币，结账时会隐藏该付款方式。
MultiSafepay 账户：您需要在 MultiSafepay Control 中获取您网站的 API 密钥。测试账户和正式账户的密钥不同。除此之外，无需在 MultiSafepay 中进行其他设置：每笔付款都会附带通知地址。
公开站点：MultiSafepay 必须能够访问您的站点才能发送通知。否则，顾客从 MultiSafepay 返回时，订单仍会被更新。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 wcp_multisafepay_gateway 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置页面：WooCommerce > Settings > Payments > MultiSafepay > Manage，或在插件列表页点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 粘贴来自 MultiSafepay Control 的测试和/或正式 API 密钥（参见「配置」）。
6. 开启 Enable/Disable 并保存。在开启 Test mode 的情况下进行一次付款测试，然后取消勾选，即可接受真实付款。
配置
所有设置都在同一个页面：WooCommerce > Settings > Payments > MultiSafepay。测试模式开启时，页面标题会显示 Test mode 标识。在字段上方，如果当前模式没有 API 密钥（此时结账时不会显示该付款方式）或 MultiSafepay 不接受店铺货币，页面会向您发出警告。在付款方式列表中，MultiSafepay 会标记为需要设置，直到当前模式具有 API 密钥为止。
结账
Enable/Disable：Enable MultiSafepay 用于启用或禁用该付款方式。默认：关闭。
Title：顾客在结账时看到的付款方式名称。默认：MultiSafepay。
Description：结账时显示在付款方式下方的文字。默认：Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay。
API 密钥
在 MultiSafepay Control > Manage settings > Website settings 中找到 API 密钥。测试账户（testmerchant.multisafepay.com）和正式账户（merchant.multisafepay.com）的密钥不同。测试模式只使用测试密钥，正式模式只使用正式密钥。
Test mode：Use the MultiSafepay test environment (no real payments)。它会同时切换 API 地址和 API 密钥。已完成的付款在状态查询和退款时仍使用其原始环境。默认：开启。
Test API key：您的 MultiSafepay 测试账户的 API 密钥。
Live API key：您的 MultiSafepay 正式账户的 API 密钥。
通知
无需配置。此部分显示通知 URL，该 URL 会随每笔付款发送给 MultiSafepay。格式类似：https://your-site/?wc-api=mspg_webhook。MultiSafepay 必须能够访问您的站点。通知只告诉插件哪笔付款发生了变化：订单变更前，状态、金额和货币始终会使用您的 API 密钥从 MultiSafepay API 读取。不属于您店铺订单的付款通知将被忽略。
订单
Order status after payment：已付款订单的状态。状态会立即设置，只进行一次状态变更并向顾客发送一封邮件。
高级
Debug log：Log API calls and notifications 会将详细信息写入 WooCommerce > Status > Logs，来源为 wcp_multisafepay_gateway。错误始终会被记录。API 密钥和顾客数据不会被记录。默认：关闭。
Delete data on uninstall：Remove settings, logs and MultiSafepay order data when the plugin is deleted。停用插件从不会删除任何内容。默认：关闭。
结账
顾客选择付款方式（默认为 MultiSafepay）并提交订单。插件会以订单货币为订单总额创建 MultiSafepay 付款，并将顾客带到 MultiSafepay 付款页面。顾客在该页面选择您 MultiSafepay 账户中启用的任意付款方式并完成付款。顾客的账单信息和店铺语言会传递给 MultiSafepay，付款会显示为 Order #、订单号以及您的网站名称。在测试模式下，结账页面会显示 Test mode: no real payment will be made.
顾客付款期间会保留库存，购物车会保留到订单接收页面。付款后，顾客会返回您店铺的订单接收页面。只有在 MultiSafepay 确认后，订单才会被标记为已付款：通过通知确认，或在顾客到达该页面时通过 MultiSafepay API 进行核查。
如果顾客在结账过程中于 MultiSafepay 页面取消，订单会按 WooCommerce 的标准方式取消，库存随即释放，商品保留在购物车中。如果顾客是在 Pay for order 页面付款，他将返回该页面，并看到说明情况的提示：The MultiSafepay payment was cancelled. You can try again or choose another payment method.、The payment was declined. Please try again or choose another payment method. 或 The payment session has expired. Please try again.
顾客可以重新支付未付款的订单。在创建新付款之前，插件会在 MultiSafepay 上检查之前的付款。如果已付款，则确认订单。如果仍未关闭且金额相同，则复用同一付款页面。如果金额已变更，则旧付款会在 MultiSafepay 中被取消，使其无法再支付。
如果 MultiSafepay 无法发起付款，顾客会看到简短提示，例如 Could not connect to MultiSafepay. Please try again in a moment. 或 MultiSafepay cannot accept this order amount or currency. Please choose another payment method.，并可选择其他付款方式。MultiSafepay 的错误信息会添加到订单备注中。
该付款方式适用于经典结账、结账区块和 Pay for order 页面。它兼容 WooCommerce 高性能订单存储（HPOS）。
插件提供一个通往 MultiSafepay 页面的付款方式。它没有为每种 MultiSafepay 付款方式单独设置的 WooCommerce 付款选项，没有嵌入式银行卡输入框，没有 Apple Pay 或 Google Pay 快捷按钮，没有订阅、定期付款或保存银行卡功能，也无法在 WooCommerce 中执行扣款或撤销。由于不发送购物车数据，MultiSafepay 不会为这些订单提供需要购物车数据的先买后付方式（例如 Klarna、in3 或 Riverty）。
订单与退款
订单状态
Pending payment：顾客已被引导至 MultiSafepay，但尚未付款。
Processing 或 Completed：MultiSafepay 已确认付款（已完成或已发货）。状态遵循 Order status after payment。订单备注会显示 MultiSafepay 付款 ID、付款方式和环境。交易 ID 为该付款的 MultiSafepay 订单 ID。
On hold before payment：付款尚未清算（MultiSafepay 正在审核）或已预授权（已授权）。请在 MultiSafepay Control 中对预授权的付款进行扣款，以收到款项。当 MultiSafepay 报告付款已完成时，订单会自动完成。
On hold after payment：MultiSafepay 确认的金额或货币与订单总额不符；商店处于正式模式时完成了测试付款（未收到真实款项）；或付款是在订单取消之后才完成的。订单备注会说明原因。请在 MultiSafepay Control 中核查该交易，并手动处理或退款。
On hold after a chargeback：MultiSafepay 报告已付款订单发生拒付：款项已从您的账户中扣回。
Failed：未付款订单的最新付款被拒绝、取消、过期或作废。被占用的库存将被释放。顾客可以重新尝试付款。
已付款、已退款或已取消的订单不会因为延迟收到的通知而重新打开。如果已付款的订单又完成了第二笔付款，订单不会再次变更。备注会提醒您在 MultiSafepay Control 中退还重复的付款。
退款
打开订单，点击 Refund，输入金额，然后点击 Refund via MultiSafepay。通过 MultiSafepay 付款的订单支持全额和部分退款。退款会发送到付款时所在的环境（测试或正式），因此必须设置该环境的 API 密钥。如果 MultiSafepay 不接受退款，WooCommerce 会显示 MultiSafepay 的错误信息，且不会记录退款。成功的请求会连同 MultiSafepay 退款 ID 一起添加到订单备注中。
在 MultiSafepay Control 中进行的退款，会在 MultiSafepay 报告后添加到订单备注中。它们不会自动记录为 WooCommerce 退款。如有需要，请在 WooCommerce 中创建手动退款，而不要使用 Refund via MultiSafepay。
许可证密钥
本插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Payments > MultiSafepay 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 从此站点移除密钥。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥只能用于一个域名。从站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效密钥时，MultiSafepay 不会在结账时向顾客显示。如果仍然发起了付款，顾客会看到 This payment method is not available. Please choose another one. 已登录的店铺管理员仍能看到该付款方式，并标有 (unlicensed — visible to admins only)，以便您在购买密钥前完成设置和测试。插件页面和 WooCommerce 页面上会出现提醒。现有订单不受影响：已发起的付款仍会被确认，退款也可以正常进行。
许可证到期后，插件仍可继续运行，但更新和技术支持需要续费。状态会在后台自动重新检查。
故障排除
结账时没有显示 MultiSafepay：请检查许可证是否有效、Enable/Disable 是否已开启、当前模式是否设置了 API 密钥（测试模式为 Test API key，正式模式为 Live API key），以及 MultiSafepay 是否接受店铺货币。如果缺少密钥或 MultiSafepay 不接受该货币，设置页面会显示警告。
已完成付款，但订单仍为 Pending payment：通知未能到达您的店铺。请检查站点是否可以从互联网访问，以及付款所在环境的 API 密钥是否已设置，因为插件会从 MultiSafepay API 读取状态。如果无法访问 API，通知会返回 ERROR，MultiSafepay 会重试。当顾客返回订单接收页面，或再次尝试支付同一订单时，订单也会被更新。
顾客下单时出现错误：请打开订单备注，或开启 Debug log 并查看 WooCommerce > Status > Logs，来源为 wcp_multisafepay_gateway。This payment method is temporarily unavailable. Please choose another payment method. 通常表示 API 密钥错误或缺失。MultiSafepay cannot accept this order amount or currency. Please choose another payment method. 表示 MultiSafepay 拒绝了该金额或货币。
订单显示 On hold after payment：请阅读订单备注。付款可能尚未清算或已预授权，已付金额或货币可能与订单不符，测试付款可能在正式模式下到达，付款可能是在订单取消后完成的，或者发生了拒付。请在 MultiSafepay Control 中核查该交易。
测试付款不会确认正式订单：商店处于正式模式时，测试付款永远不会为订单付款；订单会被置于保留状态。切换到正式模式后，之前的测试付款仍会使用测试密钥进行核查和退款。
退款因环境相关的信息而失败：付款是在测试或正式环境中进行的，而该环境的 API 密钥未设置。请输入该密钥后重试。
许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now，为新域名激活密钥。如果无法连接许可证服务器，插件将继续使用最近一次已知的状态运行。
卸载
停用插件会保留所有数据。如需删除，请先在 Plugins 页面停用并删除。本插件的许可证密钥和许可证状态始终会被删除。只有在开启了 Delete data on uninstall 时，网关设置、订单上保存的 MultiSafepay 数据和日志才会被删除；否则它们会保留，以便日后重新安装。现有订单会保留其付款备注和交易 ID。
MultiSafepay 是其各自所有者的商标。本插件与 MultiSafepay 无关联，也未获得 MultiSafepay 的认可。