概述
VibeFox Viva Wallet Gateway 为 OpenCart 3 和 OpenCart 4 添加 Viva Wallet（Viva.com）Smart Checkout 支付功能。顾客在最后一步结账时点击 Confirm Order，随后被转到 Viva 的安全支付页面，可使用银行卡、Apple Pay、Google Pay 或您 Viva 账户中启用的本地支付方式付款，付款后返回您的店铺。银行卡信息从不经过您的网站。OpenCart 会在付款前创建订单，但只有通过 Viva API 验证付款后，订单才会获得状态，因此未付款的尝试会保持为缺失订单。
本扩展适合拥有 Viva 商户账户、希望使用托管支付页面而不是在自有网站上放置银行卡表单的店铺。扩展仅支持一次性付款，不支持预授权和扣款、分期付款、保存的银行卡、订阅、您自有页面上的银行卡输入框或 POS 终端；在 Viva 后台进行的退款不会被导入。
主要功能
Smart Checkout：以订单货币为订单总额创建 Viva 支付订单，并使用该货币正确的最小单位。
仅在 Viva 确认后才标记为已付款：Viva 的 Webhook 不签名，因此扩展会通过 Viva API 重新读取每笔交易。该交易必须属于本订单的支付订单、已完成，并且与订单金额和货币一致。
Webhook 与返回：订单通过 Viva Webhook 或顾客返回店铺时获得状态。Viva 的 Webhook URL 验证会自动使用您的 Merchant ID 和 API Key 进行响应。
避免重复处理：重复或并发的 Webhook 与返回永远不会将同一笔付款应用两次。一个购物车只付款一次，迟到的付款也不会重新打开已取消或已退款的订单。
金额和货币检查：如果不一致，订单会进入您选择的审核状态，并附带备注。
演示和正式账户：两者分别使用独立的凭据。已发起的付款会在付款时所用的账户中进行验证和退款，即使您之后切换了 Test Mode 也是如此。
在订单页面退款：在订单的 VibeFox Viva Wallet Gateway 选项卡中进行全额和部分退款，最高可退至 Viva 实际扣款的金额，退款使用付款时的账户和货币，并可查看退款记录、付款尝试和 Viva 备注。
OpenCart 设置：您自己的订单状态、地区、最低订单金额和排序。Viva 付款页面的品牌颜色，日志不包含密钥或顾客数据。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包中包含两个版本的安装包。一个带有 Smart Checkout 凭据（Client ID 和 Client Secret）以及付款来源（Source Code）的 Viva 商户账户。订单货币为 EUR、GBP、PLN、RON、BGN、CZK、HUF、DKK、SEK、NOK 或 CHF。一个从 vibefox.net 获取的 VibeFox 许可证密钥（每个域名一个密钥）。