概述
VibeFox Iugu Gateway 为巴西的商店在 OpenCart 3 和 OpenCart 4 中添加 Iugu 付款功能。顾客在结账的最后一步点击 Confirm Order,扩展会创建一张 Iugu 发票,并将顾客带到 Iugu 发票页面,顾客可在该页面使用信用卡、boleto 或 PIX 付款。OpenCart 在付款前就会创建订单,但只有在从 Iugu API 重新读取发票之后,订单才会获得状态,因此未付款的尝试会以缺失订单的形式保留。
它适合以巴西雷亚尔(BRL)销售、希望在自己的网站上不设付款表单、直接接受信用卡、boleto 和 PIX 付款的商店。扩展仅支持一次性付款。它没有站内信用卡表单,不支持保存卡片、订阅、分期付款手册(carnê)或拆分付款。
主要功能
Iugu 发票页面:为订单总额创建一张 BRL 发票,3 天后到期,可用信用卡、boleto 或 PIX 支付,支持的方式取决于您 Iugu 账户中启用的方式。
仅在 Iugu 确认后才标记为已付款:通知中不包含商店可以信任的付款数据。发票始终从 Iugu API 重新读取,金额和货币会与订单进行比对。如有不符,订单会进入带备注的审核状态。之后 OpenCart 会发送常规的订单电子邮件。
Boleto 和 PIX:生成了 boleto 或 PIX 付款码的顾客会获得等待状态。当 Iugu 报告已收到款项时,订单会转为已付款状态。
避免重复处理:重复的通知和返回操作绝不会重复应用同一笔付款。一个购物车只会付款一次:在创建新发票之前,购物车中未结的发票会被重复使用或在 Iugu 中取消。
测试和正式令牌:每种模式使用独立的 API 令牌。状态查询和退款始终使用创建发票时所在模式的令牌。
订单页面退款:在订单的 VibeFox Iugu Gateway 标签页中,可对信用卡进行全额和部分退款,对 PIX 进行全额退款;只有 Iugu 确认后才计入。全额退款会设置 Refunded 状态。
您自己的订单状态:为已付款、等待、审核中、已过期、已取消和已退款的发票选择 OpenCart 状态。
OpenCart 条件:地理区域、最低订单总额和排序。CPF/CNPJ 取自名为 CPF 或 CNPJ 的自定义字段。可选日志,不记录令牌或顾客数据。
要求
OpenCart 3.0.x(已在 3.0.5.0 上测试)或 OpenCart 4.0.2 及更高版本(已在 4.1.0.3 上测试),PHP 8.0 或更高版本。同一个下载文件包含两个版本的安装包。以巴西雷亚尔(BRL)作为商店货币。一个 Iugu 账户,并同时拥有测试和正式 API 令牌。从 vibefox.net 获取的 VibeFox 许可证密钥(每个域名一个密钥)。
