VibeFox GMO for WooCommerce — 帮助
系统要求
WordPress: 6.0 或更高版本。
WooCommerce: 8.0 或更高版本，且已安装并启用。缺少 WooCommerce 时，插件将拒绝启用。
PHP: 8.0 或更高版本。
店铺币种： 日元（JPY）。店铺使用其他币种时，结账时会隐藏此付款方式。在 Pay for order 页面，以订单币种为准。
GMO Payment Gateway 账户： 包含 Link Type Plus 的 GMO-PG 商户合同。您需要测试和/或正式环境的 Shop ID、Shop password 和 Link Type Plus Config ID（設定ID），并在 GMO-PG 店铺控制台启用结果通知（結果通知）（参见“配置”）。不使用 Site ID 和 Site password。
VibeFox 许可证密钥： 在 vibefox.net 购买。一个密钥适用于一个域名。
安装
1. 在 WordPress 中前往 Plugins > Add New > Upload Plugin，选择插件 ZIP 文件并点击 Install Now。您也可以通过 FTP 将 wcp_gmo_payment 文件夹上传至 /wp-content/plugins/。
2. 点击 Activate。
3. 打开设置：WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card > Manage，或在插件页面点击插件名称下方的 Settings。
4. 在页面顶部的许可证区域输入您的 VibeFox 许可证密钥，然后点击 Activate。
5. 输入测试和/或正式环境的 Shop ID、Shop password 和 Config ID，并选择 Environment。
6. 在 GMO-PG 店铺控制台启用 結果通知（结果通知），并设置插件设置中显示的通知 URL（参见“配置”）。
7. 启用 Enable/Disable。在测试环境中进行一次测试付款，然后将 Environment 切换到正式环境。
配置
所有设置都在同一页面：WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card。页面标题会以 TEST 或 PRODUCTION 标记显示当前环境。如果店铺币种不是 JPY，或当前环境缺少 Shop ID、Shop password 或 Config ID，页面会在字段上方显示警告。这两种情况都会使该付款方式在结账时隐藏。在付款方式列表中，直到填写当前环境的凭据之前，该网关都会标记为需要设置。保存时会去掉凭据首尾的空格。
Enable/Disable: Enable GMO Payment Gateway — Credit Card 用于启用或停用此付款方式。默认值：关闭。
Title: 结账时显示的付款方式名称。默认值：Credit card。
Description: 结账时在付款方式下方显示的文字。默认值：You will be redirected to the secure GMO Payment Gateway page to pay by credit card.
GMO-PG 账户
Shop ID 和 Shop password 位于 GMO-PG 店铺控制台的 Shop management > Shop information 下，Config ID 位于 Link Type Plus > Settings（設定ID）下。测试和正式环境使用不同的凭据。
Environment: 接收付款的 GMO-PG 环境。
正式环境凭据（p01.mul-pay.jp）
Production Shop ID: 正式环境的 Shop ID。
Production Shop password: 正式环境的 Shop password。
Production Config ID: 在 GMO-PG 控制台注册的 Link Type Plus 配置 ID（設定ID）。
测试环境凭据（pt01.mul-pay.jp）
Test Shop ID: 测试环境的 Shop ID。
Test Shop password: 测试环境的 Shop password。
Test Config ID: 测试环境的 Link Type Plus 配置 ID（設定ID）。
付款
Capture: 从卡中扣款的时间。
Order status after payment: 已付款订单的状态。立即设置，只变更一次状态并发送一封顾客邮件。
付款通知（結果通知）
结果通知会告知您的店铺已发生付款。这是必需的。请在 GMO-PG 店铺控制台启用 結果通知（结果通知），并将通知 URL 设为此设置部分显示的地址。格式类似 https://your-site/wc-api/gmo_pg_webhook/。请完全按照设置中显示的内容复制 URL。
GMO-PG 通知没有签名，因此插件绝不会直接信任其内容。通知必须来自您已配置的某个 Shop ID，并对应本店在订单付款环境中创建的付款。插件随后使用您的 Shop password 向 GMO-PG 查询交易（SearchTrade），并仅根据该响应更改订单。不匹配真实交易的通知不会更改任何内容。对于非本店创建的交易，例如在 GMO-PG 控制台发起的交易，插件会确认收到通知并忽略交易。当插件无法核验通知时，会作出让 GMO-PG 再次发送的响应（GMO-PG 最多重试 5 次）。
没有通知时，只有顾客在付款后返回店铺，订单才会得到确认。
高级
Debug log: Log API requests and notifications 将其写入 WooCommerce > Status > Logs，日志来源为 wcp_gmo_payment。错误始终会被记录。密码和顾客数据会被遮蔽。默认值：关闭。
Delete data on uninstall: Delete the gateway settings and logs when the plugin is deleted。停用插件绝不会删除任何内容。订单数据（交易 ID）始终保留。默认值：关闭。
结账
顾客选择付款方式（默认为 Credit card）并下单。插件按四舍五入至整数日元的订单总额创建 GMO-PG Link Type Plus 付款，并将顾客转到 GMO-PG 付款页面。顾客在那里使用信用卡付款。3-D Secure 2.0 由 GMO-PG 处理，顾客的账单电子邮箱会传给 GMO-PG，用于 3-D Secure。付款页面会根据您的网站语言以日语、中文或英语打开。GMO-PG 中的付款显示为 WC- 加订单号。不会发送其他顾客数据。
付款后，顾客返回您的店铺。插件使用您的 Shop password 核验签名结果，只有 GMO-PG 确认付款后才会将订单标记为已付款：确认方式为顾客返回时的服务器端 SearchTrade 请求，或结果通知。两者使用相同逻辑，因此订单绝不会被重复处理。如果付款尚未确认，订单已接收页面会显示 Your card payment is being confirmed by GMO Payment Gateway. You will receive an e-mail as soon as it is confirmed.
如果信用卡被拒或在 GMO-PG 页面付款失败，订单会变为失败，顾客会被转到 Pay for order 页面并看到消息 The card payment was declined or could not be completed. Please try again or use another card. 如果顾客未付款就离开 GMO-PG 页面，同一页面会显示 The payment was not completed. You can try again or choose another payment method. 每次新的尝试都会取消上一个尚未付款的付款链接。如果上一个链接在此期间已经付款，则会应用该笔付款，不再创建新链接。
可支付的订单总额为 1 至 9,999,999 JPY。超过该范围时会隐藏此付款方式。如果无法发起付款，顾客会看到一条简短消息，例如 Card payment could not be started. Please try again or choose another payment method.，原因会添加到订单备注中。
此付款方式适用于经典结账、购物车和结账区块以及 Pay for order 页面。在结账区块中，会显示银行卡图标和说明。在测试环境中，经典结账和结账区块都会显示 Test mode — no real charge 标记。兼容 WooCommerce 高性能订单存储（HPOS）。
本插件仅接受 JPY 信用卡付款，并始终在 GMO-PG 页面付款。不支持其他 GMO-PG 付款方式、多币种、保存银行卡或 GMO-PG 会员注册、订阅或定期扣款，也不提供站内银行卡表单。
订单与退款
订单状态
Pending payment: 顾客已被转到 GMO-PG 但尚未付款，或 GMO-PG 尚未确认付款。
Processing or Completed: 付款已确认。状态遵循 Order status after payment 设置。订单备注会显示金额、GMO-PG 状态、交易及确认方式（通知或返回）。交易 ID 为 GMO-PG TranID。
On hold (authorized): 使用 Authorize only (仮売上) 时，金额已获授权。请在授权过期前使用订单操作 Capture payment (GMO-PG) 或在 GMO-PG 控制台扣款。扣款后，订单变为处理中或已完成。如果在 GMO-PG 取消授权，订单也会取消。
On hold after payment: GMO-PG 报告的金额与订单总额不同，或付款在订单取消后才到达。订单备注会说明原因。请检查订单并履行订单或退还付款。
Failed: 信用卡被拒或未在 GMO-PG 页面完成付款。
如果已付款或已关闭的订单收到第二笔付款，订单不会更改。备注会提示您在 GMO-PG 控制台退还重复付款。
扣款
订单操作 Capture payment (GMO-PG) 会出现在仅授权且处于保留状态的订单中。它会扣取已授权的金额。如果交易不再处于授权状态，例如已经在 GMO-PG 控制台扣款，该操作会添加包含当前状态的备注，并按该状态处理。
退款
打开订单，点击 Refund，输入金额，然后点击 Refund via Credit card（按钮显示您的 Title）。支持以整数日元进行全额和部分退款。退还全部剩余金额会取消 GMO-PG 交易，由 GMO-PG 决定按撤销还是退回款项处理。部分退款会降低交易金额，发卡机构会授权新的金额。退款会发送到订单付款时的环境，因此必须设置该环境的 Shop ID 和 Shop password。如果 GMO-PG 不接受退款，WooCommerce 会显示错误，不会记录退款。成功的退款会添加到订单备注中。
在 GMO-PG 控制台执行的退款和取消会通过结果通知到达，并添加到订单备注中。它们不会自动记录为 WooCommerce 退款。如有需要，请在 WooCommerce 中创建手动退款，不使用 GMO-PG 按钮。
许可证密钥
插件使用来自 vibefox.net 的 VibeFox 许可证密钥。许可证区域位于 WooCommerce > Settings > Payments > GMO Payment Gateway — Credit Card 顶部。将密钥粘贴到 License key 并点击 Activate。该区域显示许可证状态，例如有效期截止日期和您的域名。使用 Check now 重新检查状态，使用 Change key 输入其他密钥，使用 Remove key 从此网站移除密钥。Manage licenses and domains in your account 链接会打开您的 vibefox.net 账户。
一个密钥适用于一个域名。从网站移除密钥不会释放其域名名额。请在您的 vibefox.net 账户中释放名额。
没有有效密钥时，顾客在结账时看不到此付款方式。如果仍然发起付款，顾客会看到 This payment method is not available. Please choose another one. 已登录的店铺管理员仍能看到标有 (unlicensed — visible to admins only) 的付款方式，让您能在购买密钥之前配置和测试插件。插件页面和 WooCommerce 页面会显示提醒。现有订单不受影响：已发起的付款仍会确认，退款和扣款仍可使用。
许可证过期后，插件仍可使用，但更新和支持需要续订。状态会在后台自动重新检查。
故障排查
结账时未显示信用卡：请检查许可证有效、Enable/Disable 已启用、店铺币种为 JPY，且当前环境已填写 Shop ID、Shop password 和 Config ID。超过 9,999,999 JPY 的订单无法用卡付款。币种或凭据有误时，设置页面会显示警告。
付款已成功，但订单仍为 Pending payment：结果通知未正常工作。在所用环境的 GMO-PG 店铺控制台中，检查 結果通知 是否启用，且 URL 是否与设置中显示的完全一致。检查是否已填写该环境的 Shop ID 和 Shop password，因为插件会用它们核验每条通知。启用 Debug log 并查看 WooCommerce > Status > Logs，来源为 wcp_gmo_payment。顾客付款后返回店铺时，订单也会得到确认。
日志显示 Notification rejected: unknown ShopID：通知来自一个 Shop ID 未列在设置中的店铺。请输入该环境的 Shop ID。
日志显示 Notification ignored ... is not a payment of this store：交易并非由本店创建，例如是在 GMO-PG 控制台发起的。无需采取任何操作。
日志显示订单在另一环境中付款：测试和正式付款相互隔离。测试通知绝不会确认正式订单，反之亦然。
顾客下单时看到错误：打开订单备注或启用 Debug log。备注会显示 GMO-PG 错误代码（ErrCode、ErrInfo）。通常是 Shop ID、Shop password 或 Config ID 有误。GMO Payment Gateway accepts payments in Japanese Yen (JPY) only. 表示订单币种不是 JPY。
付款后订单为 On hold：请阅读订单备注。订单可能仅获授权、正在等待扣款，实付金额与订单金额不同，或付款在订单取消后才到达。
退款失败：请阅读消息。订单可能在另一环境付款，而该环境的 Shop ID 和密码未设置；交易可能已在 GMO-PG 取消；或退款金额超过交易剩余金额。
许可证区域显示错误：请按照该区域的消息操作。例如，密钥已用于其他域名时，请在您的 vibefox.net 账户中释放名额，然后点击 Check now。网站地址变更时，点击 Check now 为新域名激活密钥。如果无法连接许可证服务器，插件会按照最后已知状态继续工作。
卸载
停用插件会保留所有数据。要移除插件，请在 Plugins 页面停用并删除它。此插件的许可证密钥和许可证状态始终会被删除。只有启用过 Delete data on uninstall，才会删除网关设置和日志。否则会保留这些数据，供日后重新安装使用。订单中存储的 GMO-PG 数据属于付款历史，始终会保留。现有订单会保留付款备注和交易 ID。
GMO Payment Gateway 是其相应所有者的商标。本插件与 GMO Payment Gateway 无关联，也未获得 GMO Payment Gateway 的认可。