概述
VibeFox Worldline Gateway 将 OpenCart 3 和 OpenCart 4 连接到 Worldline Direct（原 Ingenico Direct）的托管结账页面。顾客在结账的最后一步点击 Confirm Order，随后被带到安全的 Worldline 付款页面，使用银行卡、电子钱包或您 Worldline 账户中启用的其他付款方式付款，然后返回您的商店。银行卡信息不会经过您的网站。OpenCart 在付款前就会创建订单，但订单只有在 Worldline 确认付款后才会获得状态，因此未付款的尝试会一直保持为缺失订单。
本扩展适用于已拥有 Worldline Direct 商户账户、希望使用托管付款页面而不在自有网站上放置银行卡表单的商店。扩展以直接销售的方式接受一次性付款。它不支持保存银行卡、订阅、嵌入式银行卡表单、在 OpenCart 中进行仅授权并随后捕获或取消的模式、附加费或自动注册 Webhook。
主要功能
Worldline Direct 托管结账：以订单货币对订单总额进行一次付款，包括 JPY 等无小数位货币和 KWD 等三位小数货币。可以使用 Merchant Portal 中的可选页面模板。
仅在 Worldline 确认后才算付款：订单状态会在顾客返回时进行服务器端状态检查后设置，或在收到带有有效 Worldline 签名的 Webhook 后设置。之后 OpenCart 会发送常规订单邮件。
金额与付款尝试核对：付款必须属于本订单的付款尝试，且金额和货币必须与订单一致。否则订单会进入带备注的审核状态。
不重复处理：重复的返回和 Webhook 绝不会重复应用同一笔付款。已付款的购物车不会再次扣款，延迟付款也不会重新打开已取消的订单，第二笔付款会在订单备注中标记。
测试与正式账户分开：测试模式使用预生产环境和测试凭据，正式模式使用生产环境和正式凭据。Check credentials 按钮会分别测试每组凭据。
在订单页面退款：在订单的 VibeFox Worldline Gateway 选项卡中进行全额和部分退款，退款金额为 Worldline 实际扣款的金额，并在原始付款的环境中进行，同时防止重复退款。
您自己的订单状态：可为已付款订单、等待捕获的已授权付款、审核中的付款、付款错误以及全额退款选择对应的 OpenCart 状态。
OpenCart 条件与日志：地区、最低订单总额和排序。错误始终会被记录，其中的密钥、银行卡信息和个人数据均已隐去。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包中包含两个版本的安装包。一个 Worldline Direct 商户账户（测试和正式），包含商户 ID（PSPID）、API 密钥和 Webhook 密钥。从 vibefox.net 获取的 VibeFox 许可证密钥（每个域名一个密钥）。