概述
VibeFox Vindi Gateway 将 OpenCart 3 和 OpenCart 4 连接到 Vindi API，适用于以巴西雷亚尔（BRL）销售的巴西店铺。顾客可在 Vindi 账单页面使用信用卡付款，也可使用 boleto、PIX 或 BolePix（boleto + PIX）付款。银行卡信息绝不会经过您的网站。对于 boleto 和 PIX，订单会立即获得您设定的等待状态，顾客可在成功页面、其账户以及订单电子邮件中获取 boleto 链接和 PIX 代码。
适合已拥有 Vindi 账户、希望接受一次性付款而无需搭建银行卡表单的巴西店铺。对于银行卡付款，OpenCart 会在付款前创建订单，但订单只有在 Vindi 确认付款后才会获得状态，因此未付款的尝试会保持为缺失订单。本扩展仅接受一次性单期付款，不支持订阅或定期扣款、已保存的银行卡、分期付款（parcelamento），也不在您的网站上提供银行卡表单，且无法退款 boleto 付款。
主要功能
四种付款方式：信用卡、boleto、PIX 和 BolePix。您可以选择在结账时提供哪些方式。
CPF / CNPJ 字段：结账时针对 boleto 和 PIX 要求填写，并通过校验位进行验证。如有可能，会用顾客的 CPF 或 CNPJ 自定义字段预先填入。
仅在 Vindi 确认后才标记为已付款：只有在扩展从 Vindi API 读回账单并核对货币、订单代码、Vindi 顾客以及确切金额之后，才会接受付款。若不一致，订单会进入暂挂状态并附带备注。
受保护的 Webhook：Webhook URL 包含一个密钥令牌，每条通知都只会触发一次通过 Vindi API 的重新检查。
防止重复付款：一个购物车只会付款一次。新的付款尝试会复用待付款的 Vindi 账单，或先将其取消。当您在 OpenCart 中取消未付款的订单时，其 Vindi 账单也会一并取消。
正式与沙盒：使用独立的 API 密钥。每笔付款都会记录其账单创建的环境，因此检查和退款始终使用该环境。
在订单页面退款：可在订单页面的扩展选项卡中对银行卡和 PIX 付款进行全额或部分退款，退款金额上限为 Vindi 实际收取的金额。全额退款会将订单设为您的已退款状态。
OpenCart 条件：地理区域、最低订单总额、排序以及您自定义的订单状态。日志不包含密钥或顾客数据。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包中包含两个版本的安装包。店铺中已设置巴西雷亚尔（BRL）货币。需要一个带有 API 密钥的 Vindi 账户（测试时还需要 Vindi 沙盒账户）。一个从 vibefox.net 获取的 VibeFox 许可证密钥（每个域名一个密钥）。