概述
VibeFox Iugu Gateway 为巴西的商店在 PrestaShop 中添加 Iugu 付款功能。在付款步骤中，顾客选择 Iugu，模块会按购物车总额创建一张 Iugu 账单，并将顾客引导至 Iugu 账单页面，顾客可在该页面使用信用卡、boleto bancário 或 PIX 付款。银行卡数据绝不会经过您的网站。只有当 Iugu 报告付款成功，或顾客带着已生成的 boleto 或 PIX 返回时，订单才会创建。
它适用于以巴西雷亚尔（BRL）销售并拥有 Iugu 账户的巴西商店。模块仅支持一次性付款。在 PrestaShop 中，它不提供站内银行卡表单、已保存的银行卡、订阅或定期扣款、carnê（分期付款簿）、拆分付款或分期设置。
主要功能
Iugu 账单页面：按购物车总额以 BRL 创建账单。顾客可使用您 Iugu 账户中启用的任意方式付款：信用卡、boleto 或 PIX。
仅在 Iugu 确认后才标记为已付款：通知和顾客返回仅告知商店需要核对哪张账单。系统始终通过 Iugu API 重新读取账单，并将其状态、金额和货币与购物车进行比对。若不一致，订单将变为 Iugu payment on hold。
无需在 Iugu 中进行设置：每张账单都包含您商店的通知网址。
不会重复处理：每个账单状态只应用一次，因此重复的通知和返回绝不会创建第二个订单，也不会重复记录付款。新的付款尝试会复用未结账单，或先在 Iugu 中取消该账单；重复付款会被标记为需退款。
支持 boleto 和 PIX：顾客带着 boleto 或 PIX 代码返回时，会得到一个处于 Awaiting Iugu payment 状态的订单；当 Iugu 报告款项已到账时，订单变为 Payment accepted。
测试和正式令牌：每种模式使用各自的 API 令牌。状态查询和退款始终使用账单创建时所处模式的令牌。
在订单页面退款：在订单的 Iugu payment 区块中，信用卡支持全额或部分退款，PIX 仅支持全额退款。在 Iugu 后台完成的退款会将订单设为 Refunded。
订单页面的 Iugu 区块：包含带 Iugu 链接的账单、付款方式、已收款与已退款金额、退款记录以及模块备注。可选日志，不包含令牌或顾客数据。
要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。购物车货币为巴西雷亚尔（BRL）。一个同时拥有测试和正式 API 令牌的 Iugu 账户。一个从 vibefox.net 获取的 VibeFox 许可证密钥（每个域名一个密钥）。