VibeFox Flow for WooCommerce — 帮助
系统要求
WordPress: 6.0 或更高版本。
WooCommerce: 8.0 或更高版本，已安装并启用。
PHP: 8.0 或更高版本。
店铺币种：智利比索（CLP）或美元（USD）。其他币种的结账页面会隐藏此付款方式。CLP 店铺应将 WooCommerce > Settings > General > Number of decimals 设为 0，因为 Flow 按整数比索收费。
Flow 账户：需要您的 Flow 账户的 API Key 和 Secret Key，可在 Flow 的 Mis datos、Datos técnicos 下找到。测试时，请在 sandbox.flow.cl 创建独立测试账户并使用其密钥。测试和正式密钥不同。无需在 Flow 账户中进行配置。
公开网站：您店铺的确认、返回和退款 URL 必须可从互联网访问，不能有维护模式、密码保护或阻止 Flow 的防火墙。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥适用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件 ZIP 文件并点击 Install Now。您也可以通过 FTP 将 wcp_flow_gateway 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Payments > Flow.cl > Manage，或在插件页面中点击插件名称下方的 Settings。
4. 在页面顶部的许可证区域输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 输入测试环境的 API Key 和 Secret Key，启用 Enable / Disable，保存后下一笔测试订单。
6. 要接受真实付款，请填入正式环境密钥并取消勾选 Sandbox mode。
配置
所有设置都在同一页面：WooCommerce > Settings > Payments > Flow.cl。当当前模式的密钥为空（此时 Flow 会在结账时隐藏）、店铺币种不受支持，或 CLP 店铺使用小数时，页面会在字段上方发出提醒（Flow 按整数比索收费，因此应将 Number of decimals 设为 0，以确保价格、总额和退款完全一致）。测试模式下会显示 Sandbox mode — 付款会发送到 sandbox.flow.cl，不会收取真实款项。在付款方式列表中，Flow 会一直标为需要设置，直到当前模式已配置密钥；测试模式下还会显示测试模式标记。
常规
Enable / Disable: Enable Flow.cl payments 用于开启或关闭此付款方式。默认值：关闭。
Title: 顾客在结账时看到的付款方式名称。默认值：Flow。
Description: 结账时显示在付款方式下方的文字。默认值：Pay with Webpay, credit or debit card, bank transfer and other methods. You will be redirected to Flow to complete the payment.
Flow API 凭据
从您的 Flow 账户（Mis datos、Datos técnicos）复制 API Key 和 Secret Key：正式密钥在 www.flow.cl，测试密钥在 sandbox.flow.cl（独立测试账户）。
Sandbox mode: Use the Flow sandbox (sandbox.flow.cl) and the sandbox keys。测试模式不会收取真实款项。默认值：开启。关闭此模式并填入正式密钥，即可接受真实付款。退款始终使用订单付款时所在的环境。
Sandbox API Key: 您的 sandbox.flow.cl 账户的 API Key。
Sandbox Secret Key: 您的 sandbox.flow.cl 账户的 Secret Key，用于对每次请求签名。
Live API Key: 您的 www.flow.cl 账户的 API Key。
Live Secret Key: 您的 www.flow.cl 账户的 Secret Key。请保密。
通知
插件在每次付款和退款时都会向 Flow 发送三个 URL，因此无需在 Flow 账户中进行配置。本节列出这些 URL：
确认中仅包含付款令牌。随后，插件会在创建付款时所在的环境中，通过带签名的请求向 Flow 查询付款状态，并仅依据 Flow 的答复进行处理。非本店铺为此订单创建的付款会被拒绝。如果没有确认，订单会在顾客从 Flow 返回时更新。
高级
Debug log: Log API calls and notifications，记录位置为 WooCommerce > Status > Logs，来源为 wcp_flow_gateway，不包含密钥或顾客数据。错误始终会记录。默认值：关闭。
Delete data on uninstall: Remove the settings and logs of this plugin when it is deleted (Flow data saved on orders is kept)。默认值：关闭。
结账
顾客选择付款方式（默认为 Flow）并下单。测试模式下，结账页面会显示 SANDBOX MODE — 付款会发送到 Flow 测试环境，不会实际扣款。必须提供有效的账单电子邮件地址。插件按订单币种为订单总额创建 Flow 付款，主题为 Order # 加订单号和网站名称，然后将顾客转到 Flow 付款页面。顾客在该页面选择您的 Flow 账户中已启用的付款方式。
付款后，顾客返回您的店铺。只有 Flow 确认后，订单才会标记为已付款：通过确认通知，或在顾客返回时通过带签名的状态请求进行确认。已付款订单或等待付款的现金凭证会转到订单已收到页面。
如果付款被拒绝，顾客会返回 Pay for order 页面（或结账页面），并看到 Your Flow payment was rejected. Please try again or choose another payment method. 如果顾客未付款就离开 Flow 页面，提示为 The Flow payment was not completed. You can try again or choose another payment method. 如果无法核验结果，提示为 We could not confirm your Flow payment yet. If you completed it, you will receive a confirmation e-mail shortly; otherwise please try again. 每次重新尝试都会创建一笔与订单绑定的新 Flow 付款。
如果 Flow 无法发起付款，顾客会看到简短提示，例如 Could not connect to Flow. Please try again in a moment. 详细信息见日志。
此付款方式适用于经典结账、结账区块和 Pay for order 页面。兼容 WooCommerce High-Performance Order Storage（HPOS）。面向顾客的文字已翻译为西班牙语（智利和西班牙）。
插件仅接受一次性付款。不支持保存银行卡、订阅、定期扣款或付款链接，也不会预先选定 Flow 付款方式。Flow 无法取消已创建的付款链接：如果顾客在支付较新的链接后又支付旧链接，订单会添加一条备注，要求您在 Flow 中退还重复付款。
订单与退款
订单状态
Pending payment: 顾客已被转到 Flow，但尚未付款。订单备注显示此次尝试的金额和 Flow 订单号。
On hold, awaiting coupon payment: 顾客已生成 Servipag 或 Multicaja 付款凭证。Flow 确认付款后，订单会发生变化。
Processing: Flow 报告付款已支付，且金额和币种匹配（仅含虚拟可下载商品的订单会变为已完成，这是 WooCommerce 的默认行为）。订单备注显示金额和 Flow 订单号。订单交易 ID 即为 Flow 订单号。
On hold, amount/currency mismatch: Flow 报告的金额或币种与订单不同。订单未被标记为已付款，请手动核验。
On hold, payment for a cancelled order: 一笔付款到账，但对应订单此前未付款就已取消。请检查订单并发货，或在 Flow 中退还款项。
Failed: Flow 拒绝了未付款订单的最近一次付款尝试。顾客可以重试。
Cancelled: 最近一次付款尝试已在 Flow 中撤销。
如果已付款订单收到另一笔付款，订单不会改变。备注会要求您在 Flow 账户中退还重复付款。已付款后又取消或退款的订单绝不会重新开启。
退款
打开订单，点击 Refund，输入金额并点击 Refund via Flow。支持全额和部分退款。退款会发送到订单付款时所在的环境（测试或正式），因此必须配置该环境的密钥，订单也必须具有账单电子邮件地址。Flow 会向顾客发送邮件以完成退款。如果 Flow 拒绝退款，WooCommerce 会显示错误且不会记录退款。成功的请求会连同 Flow 退款编号和状态添加到订单备注中。
Flow 后续报告的退款状态变更会添加到订单备注中。如果 Flow 之后拒绝或取消退款，备注会说明款项尚未退还顾客；WooCommerce 的退款记录会保留，因此请手动处理。在 Flow 控制面板中创建的退款不会导入 WooCommerce。
许可证密钥
插件使用来自 vibefox.net 的 VibeFox 许可证密钥。许可证区域位于 WooCommerce > Settings > Payments > Flow.cl 顶部。将密钥粘贴到 License key 并点击 Activate。该区域会显示状态，例如许可证有效截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 从此网站移除密钥。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥适用于一个域名。从网站移除密钥不会释放该域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，结账页面不会向顾客显示 Flow。如果仍然发起了付款，顾客会看到 This payment method is not available. Please choose another one. 已登录的店铺管理员仍可看到此付款方式，并标有 (unlicensed — visible to admins only)，以便您在购买密钥前配置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响：已发起的付款仍会得到确认，退款仍可使用。
许可证过期后，插件仍会继续运行，但更新和支持需要续订。状态会在后台自动重新检查。
故障排除
Flow 未显示在结账页面：请检查许可证是否有效、Enable / Disable 是否开启、当前模式的密钥是否已填写（测试模式用测试密钥，正式模式用正式密钥），以及店铺币种是否为 CLP 或 USD。在 Pay for order 页面会检查订单币种。
付款已成功，但订单仍为Pending payment：Flow 确认未到达您的店铺，顾客也未返回。请检查设置中显示的确认 URL 是否能从互联网访问，且未被维护模式、密码保护或防火墙阻止。开启 Debug log，查看 WooCommerce > Status > Logs，来源为 wcp_flow_gateway。
确认返回 Payment does not belong to the order 或 Unknown order：付款并非由本店铺为此订单创建，或创建于其他环境。订单不会改变。
确认返回 Gateway not configured：付款所在环境的密钥为空。请重新输入。
确认返回 Flow API unavailable：向 Flow 查询状态的请求失败。Flow 会重试确认。
顾客看到 Flow payments are not available at the moment：密钥缺失或被 Flow 拒绝。请检查当前模式的 API Key 和 Secret Key。
顾客看到 A valid billing email is required for Flow payments：Flow 需要顾客的电子邮件地址。
顾客已付款，但订单为On hold：请阅读订单备注。顾客生成了尚未支付的现金凭证，或 Flow 报告的金额或币种与订单不匹配。带小数的 CLP 总额会四舍五入为整数比索，因此请将 Number of decimals 设为 0。
退款失败，提示涉及测试或正式密钥：订单是在该环境中付款的，但其密钥为空。请输入密钥后重试。
许可证区域显示错误：请按照该区域中的提示操作。例如，如果密钥已用于其他域名，请在您的 vibefox.net 账户中释放一个名额，再点击 Check now。如果网站地址已改变，请点击 Check now 为新域名激活密钥。如果无法连接许可证服务器，插件会按上次已知的状态继续运行。
面向开发者，readme 中列出了过滤器 wc_flw_supported_currencies（提供此网关的币种）。
卸载
停用插件会保留所有数据。要移除插件，请在 Plugins 页面停用并删除它。此插件的许可证密钥和许可证状态始终会被移除。只有启用了 Delete data on uninstall，才会移除网关设置和日志。否则这些内容会保留，供日后重新安装使用。订单中保存的 Flow 数据始终保留。现有订单会保留付款备注和交易 ID。
Flow 是其相应所有者的商标。本插件与 Flow 无关联，也未获得 Flow 的认可。