概述
VibeFox Vindi Gateway 将 PrestaShop 与 Vindi API 连接，适用于在巴西销售、使用巴西雷亚尔（BRL）结算的商店。顾客可在 Vindi 账单页面使用信用卡付款，也可选择 boleto、PIX 或 BolePix（boleto + PIX）付款。银行卡数据绝不会经过您的网站。对于 boleto 和 PIX，订单将保持 Awaiting Vindi payment 状态，顾客会在订单确认页面、「我的账户」和电子邮件中收到 boleto 链接以及 PIX 二维码和可复制粘贴的 PIX 代码。
本模块适合已拥有 Vindi 账户、希望进行一次性付款而无需自建银行卡表单的巴西商店。对于银行卡付款，只有在 Vindi 确认付款后才会创建订单，因此中途放弃的付款不会留下未付款订单。本模块仅接受单笔、一期付款。它不支持订阅或定期扣款、保存银行卡、分期付款（parcelamento），也不会在您的网站上显示银行卡表单，并且无法退还 boleto 付款。
主要功能
四种付款方式：信用卡、boleto、PIX 和 BolePix。您可以选择在结账时提供哪些方式。
CPF / CNPJ 字段：在结账时为 boleto 和 PIX 付款收集，并通过校验位进行验证。可能时会根据顾客的地址信息自动预先填写。
仅在 Vindi 确认后才标记为已付款：模块从 Vindi API 读取账单，并核对货币、购物车编号、Vindi 客户和准确金额后，才会接受付款。如果不一致，订单将转为保留状态并附带备注。
受保护的 Webhook：Webhook URL 包含一个密钥令牌，每条通知只会触发一次通过 Vindi API 的重新核查。
避免重复付款：新的付款尝试会复用待处理的 Vindi 账单，或先将其取消。在商店中取消未付款订单时，其 Vindi 账单也会一并取消。
正式环境与测试环境：API 密钥分开设置。每笔付款都会记录其账单的创建环境，因此核查和退款始终在该环境中进行。
订单页面退款：可在 Vindi payment 区块对信用卡和 PIX 付款进行全额或部分退款，退款金额不超过 Vindi 实际收取的金额。全额退款会将订单设为 Refunded。
订单页面的 Vindi 区块：购物车的账单、退款记录和模块备注。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本，商店货币为巴西雷亚尔（BRL）。需要一个带 API 密钥的 Vindi 账户（测试时还需要 Vindi 测试环境 sandbox 账户）。还需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名对应一个密钥）。