概述
VibeFox Viva Wallet Gateway 为 PrestaShop 添加 Viva Wallet（Viva.com）Smart Checkout。在付款步骤，顾客选择 Viva Wallet，被引导至安全的 Viva 付款页面，使用银行卡、Apple Pay、Google Pay 或您 Viva 账户中启用的本地付款方式付款，然后返回您的店铺。银行卡数据绝不会经过您的网站。只有在 Viva 确认付款后才会创建订单，因此中途放弃的付款不会留下未付款订单。
本模块适合拥有 Viva 商户账户、希望使用托管付款页面而非在自有网站上输入银行卡表单的店铺。本模块仅支持一次性付款。不支持预授权和捕获、分期付款、保存的银行卡、订阅、在自有页面输入银行卡字段或 POS 终端，并且在 Viva 后台进行的退款不会被导入。
主要功能
Smart Checkout：系统会按购物车金额和购物车币种创建 Viva 付款订单，并使用该币种正确的最小单位。
仅在 Viva 确认后才标记为已付款：Viva Webhook 未经签名，因此模块会通过 Viva API 重新读取每笔交易。该交易必须属于本购物车的 Viva 付款订单，已完成，并且金额与币种与购物车一致。
Webhook 与返回：订单由 Viva Webhook 创建，或在顾客返回店铺时创建。Viva 的 Webhook URL 验证会自动使用您的 Merchant ID 和 API Key 进行响应。
避免重复处理：重复或并行的 Webhook 与返回操作绝不会创建第二个订单，也不会两次记录付款。延迟到达的付款也绝不会重新打开已取消或已退款的订单。
金额与币种检查：金额不一致时，订单会被置于 Viva Wallet payment on hold 状态等待审核，并附带备注。
演示与正式账户：为每个账户分别设置凭据。已发起的付款会在其发生时所在的账户中进行验证和退款，即使您之后切换了 Test Mode 也是如此。
订单页面退款：可在订单的 Viva Wallet payment 模块中进行全额和部分退款，最高不超过 Viva 收取的金额，退款在付款所在的账户和币种中进行。全额退款会将订单设为 Refunded。
订单页面的 Viva 模块：交易、付款尝试、退款历史和备注。付款后的订单状态可自行选择，日志不包含密钥或顾客数据。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。一个 Viva 商户账户，并具备 Smart Checkout 凭据（Client ID 和 Client Secret）以及付款来源（Source Code）。购物车币种为 EUR、GBP、PLN、RON、BGN、CZK、HUF、DKK、SEK、NOK 或 CHF。一个来自 vibefox.net 的 VibeFox 许可证密钥（每个密钥对应一个域名）。