VibeFox 2C2P for WooCommerce — 帮助
系统要求
WordPress：5.8 或更高版本。
WooCommerce：6.0 或更高版本，已安装并启用。未安装 WooCommerce 时，插件会在管理区域显示提示，且该付款方式不会加载。
PHP：8.0 或更高版本。
2C2P 账户：您需要 2C2P 商户账户的 Merchant ID 和 Secret Key。开通商户账户时由 2C2P 发放。沙盒账户与正式账户的密钥不同。开发者文档和沙盒测试卡位于 developer.2c2p.com。
币种：店铺币种须为插件支持的币种，并已在您的 2C2P 账户中启用。支持的币种包括但不限于 THB、SGD、MYR、PHP、IDR、VND、MMK、KHR、LAK、CNY、HKD、TWD、JPY、KRW、INR、AUD、NZD、USD、EUR 和 GBP。若店铺币种不受支持，该付款方式将在结账时隐藏。
VibeFox 许可证密钥：在 vibefox.net 购买。一个密钥仅适用于一个域名。
安装
1. 在 WordPress 中进入 Plugins > Add New > Upload Plugin，选择插件 ZIP 文件，然后点击 Install Now。您也可以通过 FTP 将 wcp_2c2p_payment 文件夹上传到 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Payments > 2C2P > Manage，或在插件页面中点击插件名称下方的 Settings。
4. 在页面顶部的许可证区块中输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 输入您的沙盒 Merchant ID 和 Secret Key，开启 Enable/Disable，并完成一笔测试订单。
6. 准备就绪后，输入正式环境的凭据，并取消勾选 Sandbox Mode。
每笔付款都会自动发送返回地址和通知地址。无需在 2C2P 后台进行任何配置。
配置
所有设置位于同一页面：WooCommerce > Settings > Payments > 2C2P。沙盒模式开启时，字段上方会显示 Sandbox mode is active. No real transactions will be processed.。若付款方式已启用，但当前模式的 Merchant ID 或 Secret Key 为空，或店铺币种不受支持，页面也会给出警告。在这两种情况下，该付款方式都会在结账时隐藏。关闭 Sandbox Mode 并保存时，若正式环境的 Merchant ID 或 Secret Key 为空，插件会要求您填写。
常规
Enable/Disable: Enable 2C2P Payment Gateway 用于开启或关闭该付款方式。默认：关闭。
Title: 顾客在结账时看到的付款方式名称。默认：2C2P Payment。
Description: 结账时付款方式下方显示的文字。默认：Pay securely via credit/debit card, e-wallet, or internet banking through 2C2P。沙盒模式下，文字末尾会加上 (TEST MODE)。
测试模式（沙盒）
Sandbox Mode: Enable sandbox / test mode 会将付款发送到 2C2P 沙盒（demo2.2c2p.com），并使用下方的沙盒凭据。默认：开启。取消勾选即可接收真实付款。
Sandbox Merchant ID: 您的 2C2P 沙盒 Merchant ID。
Sandbox Secret Key: 您的 2C2P 沙盒 Secret Key。
正式环境 API 凭据
关闭沙盒模式时使用。
Merchant ID: 您的 2C2P 正式环境 Merchant ID。关闭沙盒模式时必填。
Secret Key: 您的 2C2P 正式环境 Secret Key。关闭沙盒模式时必填。该密钥会按输入的原样保存，包括引号和反斜杠。
付款页面
本节仅供参考，显示前端返回地址（https://your-site/?wc-api=tc2p_p）和后端通知地址（https://your-site/?wc-api=tc2p_p&tc2p_p_s2s=1）。每笔付款都会自动发送这两个地址。
Payment Page Language: 2C2P 付款页面的语言。默认：English。
Redirect API version: 请保持 8.5，除非 2C2P 告知您的账户仍在使用旧版 7.0（SHA-1 签名）。切换版本前发起的付款结果仍会被校验。
Order ID prefix: 可选，仅限字母和数字（最多 10 位），例如 SHOP1。2C2P 会拒绝已出现过的订单号。当多家店铺共用一个 2C2P 账户时，或在沙盒中（测试商户账户由许多开发者共用）时，请设置唯一的前缀。保存时会自动删除其他字符，并给出警告。
高级
Enable Logging: Log 2C2P events 会写入 WooCommerce > Status > Logs，来源为 wcp_2c2p_payment。日志不记录银行卡数据或 Secret Key。默认：关闭。
Delete Data on Uninstall: Delete the gateway settings, 2C2P order meta and log files when the plugin is deleted。默认：关闭。
结账
顾客选择付款方式（默认为 2C2P Payment）并下单。下一页会显示 Thank you for your order. You will be redirected to 2C2P to complete your payment.，片刻后将顾客转到 2C2P 付款页面。若没有自动跳转，顾客可点击 Pay via 2C2P。该页面还有一个 Cancel order 按钮。
在 2C2P 页面上，顾客可使用您 2C2P 账户中启用的任何方式付款，例如银行卡、电子钱包、二维码付款、网上银行或现金付款。插件会传递订单总额（以订单币种计）、顾客的账单电子邮件地址以及所购商品的名称。付款需在 24 小时内完成。
2C2P 会以两种方式报告结果：顾客的浏览器返回店铺，以及 2C2P 发送服务器间通知。两者的处理方式相同。只有当 2C2P 以有效签名确认后，订单才会被标记为已付款。结果还必须与该订单相符：会核对商户 ID、订单密钥、订单号和付款方式。没有有效签名的结果会被拒绝。
付款成功或处于待处理状态后，顾客会进入订单已收到页面，购物车会被清空。若付款未完成，顾客将返回结账页面，并看到提示 Payment was not completed. Please try again or choose a different payment method.。订单将被取消，购物车保留，顾客可重新下单。若无法确认结果，顾客会看到 We could not confirm the payment result. If your account was charged, please contact us before paying again.
该付款方式支持经典结账和结账区块。兼容 WooCommerce 高性能订单存储（HPOS）。
插件不支持从 WooCommerce 退款，不保存银行卡，不支持定期付款或 WooCommerce Subscriptions，您的网站上没有银行卡输入框，也不支持 2C2P PGW 4.x API。
订单
订单状态
Pending payment: 顾客已被转到 2C2P，但尚未收到任何结果。
Processing or Completed: 2C2P 报告付款成功（状态 000）。WooCommerce 会将订单设为处理中；仅含虚拟可下载商品的订单则设为已完成。订单备注会显示 2C2P 交易号、授权码、日期和付款渠道。交易 ID 即为 2C2P 交易参考号。
On hold: 付款在 2C2P 处于待处理状态（状态 001），例如顾客尚未支付的现金付款。2C2P 报告付款后，订单才会变为已付款。若 2C2P 报告的金额或币种与订单总额不同，订单也会被设为保留。订单备注会显示收到的值和预期值。请在 2C2P 后台核对订单和交易。
Cancelled: 付款被拒绝、被顾客取消或失败（状态 002、003、999）。订单备注会显示状态和原因。
已付款或已退款的订单不会因之后的结果而改变；重复的旧结果也不会重新打开您已取消的订单。
退款
不支持从 WooCommerce 退款。请先在 2C2P 商户后台退款，然后在 WooCommerce 中创建手动退款记录。
许可证密钥
本插件需要来自 vibefox.net 的 VibeFox 许可证密钥。许可证区块位于 WooCommerce > Settings > Payments > 2C2P 页面顶部。将密钥粘贴到 License key 中，然后点击 Activate。该区块会显示状态，例如许可证有效期截止日期以及您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 将其从本站点移除。链接 Manage licenses and domains in your account 会打开您的 vibefox.net 账户。
一个密钥仅适用于一个域名。从站点移除密钥并不会释放其域名名额。请在您的 vibefox.net 账户中释放该名额。
没有有效密钥时，结账时不会向顾客显示 2C2P。若仍发起付款，顾客会看到 This payment method is not available. Please choose another one.。已登录的店铺管理员仍可看到该付款方式，并标注 (unlicensed — visible to admins only)，以便您在购买密钥前设置和测试插件。插件页面和 WooCommerce 页面上会显示提醒。现有订单不受影响：已发起的付款仍会被确认。
许可证到期后，插件仍可继续使用，但更新和支持需要续费。系统会在后台自动重新检查状态。
故障排除
结账时未显示 2C2P：请检查许可证是否有效、Enable/Disable 是否开启，以及当前模式是否已填写 Merchant ID 和 Secret Key：沙盒模式下填写沙盒字段，正式环境下填写正式环境字段。检查店铺币种是否受支持。设置页面会在这两种情况下显示警告。
付款已完成，但订单仍为待付款：没有有效结果到达您的店铺。请检查当前模式的 Merchant ID 和 Secret Key 是否与付款所用的 2C2P 账户一致，以及 Redirect API version 是否与您的账户匹配。签名错误或商户 ID 不符的结果会被拒绝。开启 Enable Logging，并在 WooCommerce > Status > Logs 中查找哈希或商户 ID 相关的消息。另请确认您的服务器允许 2C2P 向后端通知地址发送请求。
2C2P 提示订单号已存在：2C2P 不接受重复的订单号。当多家店铺共用一个 2C2P 账户时，或在沙盒中（测试商户账户由许多开发者共用）时，会出现此情况。请设置唯一的 Order ID prefix。
已付款但订单为保留状态：要么付款仍在 2C2P 处于待处理状态（例如顾客尚未支付的现金付款），要么已付金额或币种与订单不符。请在订单备注和 2C2P 后台查看交易。
顾客看到 This payment method is currently unavailable for this order：订单币种不受支持，或当前模式的 Merchant ID 或 Secret Key 为空。
保存时出现 Please enter your live Merchant ID or Please enter your live Secret Key 提示：关闭沙盒模式且正式环境字段为空。请填写正式环境凭据，或保持 Sandbox Mode 开启。
许可证区块显示错误：请按照区块中的提示操作。例如，若该密钥已在其他域名上使用，请在您的 vibefox.net 账户中释放一个名额，然后点击 Check now。若站点地址已更改，请点击 Check now，为新域名激活密钥。若无法连接许可证服务器，插件将继续使用最后已知的状态。
卸载
停用插件会保留所有数据。要移除插件，请先停用，然后在 Plugins 页面将其删除。本插件的许可证密钥和许可证状态始终会被移除。仅当开启了 Delete Data on Uninstall 时，才会移除网关设置、订单上存储的 2C2P 数据和日志文件。否则它们将保留，以便日后重新安装时使用。现有订单保留其付款备注和交易 ID。
2C2P 是其各自所有者的商标。本插件与 2C2P 无关联，也未获得 2C2P 认可。