VibeFox Moneris for WooCommerce — 帮助

系统要求

WordPress：6.0 或更高版本。

WooCommerce：8.0 或更高版本，须已安装并启用。未安装 WooCommerce 时，插件无法启用。

PHP：8.0 或更高版本。

店铺货币：加拿大 Moneris 账户使用 CAD，旧版 Moneris USA 账户使用 USD。只有当订单货币与账户货币一致时，才会显示此支付网关。

HTTPS 与 PCI DSS：银行卡号在您的结账页面输入，并经过您的服务器。正式付款需要 HTTPS，并符合 PCI DSS SAQ D 标准。如果无法满足，请改用托管支付页面的解决方案。

Moneris 账户：您需要从 Moneris Merchant Resource Center > Admin > Store Settings 获取 Moneris Gateway 店铺的 Store ID 和 API Token。测试时，默认已填入 Moneris 公共测试店铺。测试凭据和测试卡可在 Moneris 开发者门户中找到。

VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥只能用于一个域名。

安装

1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件的 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 wcp_moneris_gateway 文件夹上传到 /wp-content/plugins/。

2. 点击 Activate。

3. 打开设置：WooCommerce > Settings > Payments > Moneris > Manage，或在插件列表页面点击插件名称下的 Settings。

4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。

5. 选择账户所在国家，并填写 Live Store ID 和 Live API Token。测试模式默认开启，使用公共测试店铺（加拿大为 store5 / yesguy，美国为 monusqa002 / qatoken）。

6. 选择 Purchase 或 Pre-Authorization 以及银行卡标识，然后开启 Enable / Disable。

7. 使用 Moneris 测试卡下一个测试订单，然后取消勾选 Test mode。

配置

所有设置都在一个页面中：WooCommerce > Settings > Payments > Moneris。测试模式开启时，页面在字段上方显示 Moneris gateway is in TEST MODE. No real charges will be made.。在正式模式下，如果正式字段中包含 Moneris 测试凭据（此时结账时会隐藏该支付网关），或者网站未使用 HTTPS，页面会发出警告。如果店铺货币与 Moneris 账户货币不一致，页面也会发出警告，此时结账时同样会隐藏该支付网关。

常规

Enable / Disable：Enable Moneris Gateway 用于开启或关闭该付款方式。默认：关闭。

Title：顾客看到的付款方式名称。默认：Credit card (Moneris)。测试模式下，结账时会在名称后添加 (Test Mode)。

Description：结账时显示在银行卡字段上方的文字。默认：Pay securely with your credit card.

Moneris 账户

您的 Store ID 和 API Token 位于 Moneris Merchant Resource Center 的 Admin > Store Settings 中。测试凭据和测试卡位于 Moneris 开发者门户。该部分包含这两者的链接。

Moneris account country：加拿大账户以 CAD 扣款，美国账户以 USD 扣款。只有当订单货币一致时才会显示该支付网关。默认：Canada (CAD)。

Canada (CAD)：Moneris Canada 账户。

United States (USD, legacy Moneris USA accounts)：Moneris USA 账户。

Test mode：Enable test mode (Moneris QA gateway, test credentials, no real charges)。退款、扣款和撤销始终发送至付款时所用的环境。顾客会在银行卡字段上方看到 TEST MODE: use a Moneris test card, no real charges are made.。默认：开启。

Live Store ID：正式环境的 Store ID，例如 monca01234。

Live API Token：正式环境的 API Token。

Test Store ID：Moneris 公共测试店铺：store5（加拿大）或 monusqa002（美国）。默认：store5。

Test API Token：公共测试 token：yesguy（加拿大）或 qatoken（美国）。默认：yesguy。

付款

Transaction type：银行卡的扣款方式。默认：Purchase。

Purchase (charge immediately)：下单时立即扣除银行卡款项。

Pre-Authorization (capture later)：仅预留资金，订单进入「保留」状态。将订单改为「处理中」或「已完成」，或使用订单操作 Capture Moneris pre-authorization 即可扣款。取消订单会释放预留资金。

Card logos：显示在付款方式名称旁的银行卡品牌标识：Visa、Mastercard、Discover、American Express、JCB。可接受的品牌取决于您的 Moneris 账户。默认：Visa and Mastercard。

高级

Debug log：Log API requests and responses (card number, CVV, expiry and API token are masked)。错误始终会被记录。日志位于 WooCommerce > Status > Logs，来源为 wcp_moneris_gateway。默认：关闭。

Delete data on uninstall：Remove the gateway settings and logs when the plugin is deleted。默认：关闭。

结账

顾客选择付款方式（默认为 Credit card (Moneris)），并在您结账页面的 WooCommerce 银行卡表单中输入卡号、有效期和安全码。下单时，您的服务器会将银行卡信息连同订单总额发送至 Moneris，并即时获得结果。没有跳转，也没有 webhook。安全码（CVD）始终会被发送，因此您的 Moneris 店铺的 eFraud 规则仍然有效。

只有当 Moneris 报告交易已完成且处理金额与订单总额一致时，已批准的付款才会被标记为已付款。随后，顾客会进入订单已接收页面。使用 Pre-Authorization 时，订单会保持在「保留」状态，直到您扣款。

如果银行卡被拒绝，顾客会看到 Your card was declined 以及 Moneris 给出的原因，并可检查卡信息或换用其他银行卡。如果 Moneris 无法处理请求（例如 Store ID 或 API Token 有误），顾客会看到 The payment could not be processed. Please try again or use another payment method. 该原因会添加到订单备注和日志中。在付款处理期间再次点击，会显示 A payment for this order is already being processed. Please wait a moment and check your order status before trying again. 已付款或已预授权的订单绝不会被再次扣款。

如果 Moneris 没有响应（网络错误或超时），插件会向 Moneris 发送 Status Check，以确认交易是否已成功。如果同样无法确认，订单会进入「保留」状态并附带 Moneris 订单 ID，且不会邀请顾客再次付款。

该付款方式适用于经典结账、结账区块和 Pay for order 页面。它兼容 WooCommerce 高性能订单存储（HPOS）。

本插件不支持保存银行卡或 Moneris Vault、WooCommerce 订阅、Apple Pay、Google Pay 或 Interac Online、Moneris Checkout 或 Hosted Tokenization、3-D Secure、AVS 或 Kount，也不支持多币种定价。

订单与退款

订单状态

待付款：订单已创建，但银行卡尚未扣款，例如在一次被拒绝的尝试之后。订单备注会显示 Moneris 代码和消息。顾客可以再次付款。

处理中：购买已获批准。仅包含虚拟可下载商品的订单会变为「已完成」，这是 WooCommerce 的默认设置。订单备注会显示金额、Moneris 交易 ID 和收据。交易 ID 即 Moneris 交易编号。

保留：预授权已获批准并等待扣款，或处理金额与订单总额不一致，或 Moneris 未确认结果。订单备注会说明原因。

已取消：对于已预授权的订单，取消会释放预留资金（撤销）。

扣款与撤销

要对预授权进行扣款，请将订单状态改为「处理中」或「已完成」，或在订单操作中选择 Capture Moneris pre-authorization。将扣除当前订单总额减去退款后的金额，且不能超过预授权金额。如果 Moneris 拒绝扣款，状态会回到「保留」并附带备注，且不会发送处理中或已完成的邮件。Moneris 预授权会在数天后过期，请及时扣款。

要释放资金，请取消订单，或在订单操作中选择 Void Moneris pre-authorization (cancel order)。将订单设置为「已退款」也会释放未结的预授权。如果释放失败，备注会提示您在 Merchant Resource Center 中手动释放。

退款

打开订单，点击 Refund，输入金额后点击 Refund via Credit card (Moneris)（按钮会显示您的 Title）。支持全额和部分退款。预授权只有在扣款后才能退款；扣款前，请取消订单以释放资金。退款会发送至付款时所用的环境和账户，因此该模式的凭据必须已填写。如果 Moneris 未接受退款，WooCommerce 会显示 Refund failed 及原因，且不会记录退款。成功的退款会连同 Moneris 交易 ID 添加到订单备注中。

许可证密钥

本插件需要一个来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Payments > Moneris 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。

一个密钥只能用于一个域名。从站点移除密钥不会释放该域名的名额。请在您的 vibefox.net 账户中释放名额。

没有有效密钥时，结账时不会向顾客显示 Moneris。即便仍有人开始付款，顾客也只会看到 This payment method is not available. Please choose another one. 已登录的店铺管理员仍能看到该付款方式，并带有 (unlicensed — visible to admins only) 标记，方便您在购买密钥前完成设置和测试。插件列表页面和 WooCommerce 页面会显示提醒。现有订单不受影响：扣款、撤销和退款仍可正常进行。

许可证到期后，插件仍可继续工作，但更新和支持需要续费。系统会在后台自动重新检查状态。

故障排除

结账时没有显示 Moneris：请检查许可证是否有效、Enable / Disable 是否开启，以及当前模式是否已填写 Store ID 和 API Token。在正式模式下，正式字段必须填写您的正式凭据，而不是 Moneris 测试凭据。请检查店铺货币（或 Pay for order 页面的订单货币）是否为账户货币：加拿大为 CAD，美国账户为 USD。货币不一致时，设置页面会显示警告。

付款已完成，但订单仍为「待付款」或「保留」：插件没有 webhook；结果只来自 Moneris 的响应。如果订单处于「保留」状态，且备注显示 Moneris 未确认结果，则说明 Moneris 没有响应，Status Check 也失败了。请在备注中找到 Moneris 订单 ID，并在 Merchant Resource Center 中查找：如果交易存在，请发货（必要时在那里退款）；如果不存在，请取消订单，或请顾客再次付款。

顾客看到 Payment gateway is misconfigured. Please contact the store administrator.：当前模式的凭据缺失，或正式模式已开启但正式字段中填写了 Moneris 测试凭据。请填写您的正式 Store ID 和 API Token。

顾客看到 This payment method does not support the order currency.：订单货币不是 Moneris 账户的货币。

顾客在付款时看到错误：请打开订单备注，或开启 Debug log，然后查看 WooCommerce > Status > Logs，来源为 wcp_moneris_gateway。

扣款失败：订单没有等待扣款的预授权，订单总额为零，或金额高于预授权金额。Moneris 预授权也会在数天后过期。

退款、扣款或撤销失败，并提示模式或账户相关信息：付款是在测试模式或正式模式下进行的，而该模式的凭据未设置；或者付款使用的是另一国家的 Moneris 账户。请填写凭据，或在 Merchant Resource Center 中处理该付款。

银行卡测试攻击：直接的银行卡表单是银行卡测试攻击的目标。请启用 WooCommerce 结账的速率限制和 CAPTCHA 插件，并在 Moneris 账户中启用 eFraud 或 velocity 规则。

许可证区块显示错误：请按照区块中的提示操作。例如，如果该密钥已在另一个域名上使用，请在 vibefox.net 账户中释放一个名额，然后点击 Check now。如果站点地址已更改，请点击 Check now 为新域名激活密钥。如果无法连接许可证服务器，插件将沿用最后已知的状态继续运行。

卸载

停用插件会保留所有数据。如需删除，请在 Plugins 页面停用并删除插件。本插件的许可证密钥和许可证状态始终会被删除。只有在开启了 Delete data on uninstall 的情况下，支付网关设置和日志才会被删除；否则会保留，以便日后重新安装。现有订单会保留其付款备注和交易 ID。

Moneris 是其各自所有者的商标。本插件与 Moneris 无关联，也未获得 Moneris 的认可。