VibeFox Barion for WooCommerce — 帮助
系统要求
WordPress：6.0 或更高版本。
WooCommerce：7.0 或更高版本，已安装并启用。未安装 WooCommerce 时，插件会在管理区域显示提示，且该付款方式不会加载。
PHP：8.0 或更高版本。
Barion 店铺：您需要店铺的 POSKey（密钥）以及接收付款的 Barion 钱包电子邮件地址。两者均可在 Barion 后台找到：正式环境为 secure.barion.com，测试环境为 secure.test.barion.com，路径为 My stores 下的您的店铺。测试与正式环境的凭据不同。
币种：店铺币种须为 HUF、EUR、USD 或 CZK。其他币种的付款方式将在结账时隐藏。
可访问的店铺：Barion 会在每笔付款后回调您的店铺，因此网站必须可从互联网访问，且 /wc-api/ 前面不得有维护模式、防火墙或基本认证。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥仅适用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 wcp_barion_gateway 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Payments > Barion > Manage，或在插件页面中点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 输入测试 POSKey 和测试钱包电子邮件，保持 Test Mode 开启，并开启 Enable/Disable。完成一笔测试订单。
6. 一切正常后，输入正式环境的凭据，并取消勾选 Test Mode。
每笔付款都会自动向 Barion 发送回调地址。无需在 Barion 后台进行任何配置。
配置
所有设置位于同一页面：WooCommerce > Settings > Payments > Barion。若店铺币种不受支持，页面会在 Barion shop credentials 区块中以红色提示此情况，并列出支持的币种；此时该付款方式将在结账时隐藏。
常规
Enable/Disable: Enable Barion Payment 用于开启或关闭该付款方式。默认：关闭。
Title: 顾客在结账时看到的付款方式名称。默认：Barion。
Description: 结账时付款方式下方显示的文字。默认：Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay。
Barion 店铺凭据
请在 Barion 后台获取 POSKey 和钱包电子邮件：正式环境为 secure.barion.com，测试环境为 secure.test.barion.com，进入 My stores 并选择您的店铺。本区块还会显示回调地址，例如 https://your-site/wc-api/barion_payment_callback/。每笔付款都会将其发送给 Barion；它只需能够从互联网访问即可。
Test Mode: Enable Barion test/sandbox mode。测试模式使用下方的测试凭据和 Barion 沙盒（api.test.barion.com），不会产生真实扣款。默认：开启。取消勾选即可接收真实付款。
Test POSKey: 您店铺在 Barion 测试系统（secure.test.barion.com，My stores）中的密钥（POSKey）。
Test Payee Email: 接收测试付款的 Barion 测试钱包电子邮件地址。
Live POSKey: 您店铺在 Barion 正式系统（secure.barion.com，My stores）中的密钥（POSKey）。
Live Payee Email: 接收付款的 Barion 钱包电子邮件地址。
订单
Order Status After Payment: 付款成功并经核实后设置的订单状态。
高级
Logging: Enable debug logging。日志保存到 WooCommerce > Status > Logs，来源为 wcp_barion_gateway。密钥绝不会被记录。默认：关闭。
Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted。订单及其 Barion 付款数据始终会被保留。默认：关闭。
结账
顾客选择付款方式（默认为 Barion）并下单。插件会以订单币种为订单总额发起 Barion 付款，并将顾客转到 Barion 付款页面。付款页面中会列出订单商品、运费、手续费和税款，顾客的账单电子邮件会作为提示传递，并且在 Barion 支持的情况下，页面语言跟随店铺语言。
付款后，顾客会返回您的店铺。Barion 也会调用回调地址。这两个请求本身都不会将订单标记为已付款：插件会使用您的 POSKey 向 Barion 查询付款状态，只有当 Barion 确认付款且金额和币种与订单相符时，订单才会被标记为已付款。返回链接包含订单密钥，且只会核对为该订单发起的付款。
若付款已在 Barion 成功或仍在处理中，顾客会进入订单已收到页面。否则，顾客会返回结账页面，并看到 Payment was not completed. Please try again.。顾客可以重试；每次尝试都会被记录，因此较早尝试的迟到付款仍会完成订单。
若无法发起付款，顾客会看到 The Barion payment could not be started. Please try again or choose another payment method.。已登录的店铺管理员还会看到技术原因。详细信息会记录在日志中。
该付款方式支持经典结账和结账区块。兼容 WooCommerce 高性能订单存储（HPOS）。
插件仅支持即时付款，不支持预留或延迟扣款付款，不支持 WooCommerce Subscriptions 或定期付款，不保存银行卡，不支持 Barion Pixel，也不提供额外的 3-D Secure 数据；3-D Secure 由 Barion 在其付款页面上处理。
订单与退款
订单状态
Pending payment: 已发起 Barion 付款，但 Barion 尚未确认。订单备注会显示 Barion PaymentId、金额，并且在测试模式下显示 (test mode)。
Processing or Completed: Barion 已确认付款。状态按 Order Status After Payment 设置。订单备注会显示金额、PaymentId 和交易。交易 ID 即为 Barion 交易 ID。
On hold: Barion 报告的金额或币种与订单总额不符，例如订单在付款发起后被修改。请在 Barion 后台核对该笔付款，并手动完成或退款。
Cancelled: 最近一次付款尝试在 Barion 被取消或过期。
Failed: 最近一次付款尝试失败。
已付款或已退款的订单绝不会因之后的回调而改变。若已付款订单又有一笔付款成功，备注会提示您在 Barion 后台核查，如属重复付款则予以退款。
退款
打开订单，点击 Refund，输入金额，然后点击 Refund via Barion。支持全额和部分退款。退款原因会作为备注发送至 Barion。HUF 退款必须为整数金额。退款会通过订单付款时所用的模式（测试或正式）发送，因此必须设置该模式的 POSKey。若 Barion 未接受或未确认退款，WooCommerce 会显示错误，且不会记录退款。成功的退款会连同 Barion 交易和状态添加到订单备注中。
许可证密钥
本插件需要来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Payments > Barion 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥仅适用于一个域名。从站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效密钥时，结账时不会向顾客显示 Barion。若仍发起付款，顾客会看到 This payment method is not available. Please choose another one.。已登录的店铺管理员仍可看到该付款方式，并标注 (unlicensed — visible to admins only)，以便您在购买密钥前设置和测试插件。插件页面和 WooCommerce 页面上会显示提醒。现有订单不受影响：已发起的付款仍会被确认，退款也可正常使用。
许可证到期后，插件仍可继续使用，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账时未显示 Barion：请检查许可证是否有效、Enable/Disable 是否开启、当前模式是否已填写 POSKey 和收款钱包电子邮件地址，以及店铺币种是否为 HUF、EUR、USD 或 CZK。
付款已完成，但订单仍为待付款：订单会在 Barion 调用回调地址或顾客返回您的店铺时完成。请确保网站可从互联网访问（维护模式、防火墙或 /wc-api/ 前的基本认证都可能阻止访问）。请检查订单付款时所用模式的 POSKey 是否正确，因为插件需要使用它向 Barion 查询付款状态。开启 Logging 可查看回调情况。
回调返回 Busy, retry：订单正在被顾客的返回请求同时处理。Barion 会再次调用。
回调返回 API error：店铺无法从 Barion 读取付款状态。请检查订单付款时所用模式的 POSKey。
订单因金额不符备注而被设为保留：Barion 报告的金额或币种与订单总额不同。请在 Barion 后台核对该笔付款，并手动完成或退款。
为什么无法退款 10.50 HUF：Barion 对 HUF 不使用小数。请输入整数金额。
退款时提示该订单模式的 POSKey 未配置：订单是在测试或正式环境下付款的，而该模式的 POSKey 为空。请填写后重试。
许可证区块显示错误：请按照区块中的提示操作。例如，若该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。若站点地址已更改，请点击 Check now，为新域名激活密钥。若无法连接许可证服务器，插件将继续使用最后已知的状态。
卸载
停用插件会保留所有数据。要移除插件，请先停用，然后在 Plugins 页面将其删除。本插件的许可证密钥和许可证状态始终会被移除。仅当开启了 Delete Data on Uninstall 时，才会移除网关设置。否则它们将保留，以便日后重新安装时使用。订单及其 Barion 付款数据始终会被保留。现有订单保留其付款备注和交易 ID。
Barion 是其各自所有者的商标。本插件与 Barion 无关联，也未获得 Barion 认可。