概述
VibeFox PagSeguro Gateway 通过 PagBank Checkout API 将 PrestaShop 与 PagBank（原 PagSeguro）连接起来。在付款步骤中，顾客选择 PagBank，模块会按购物车的确切金额创建一笔 PagBank 付款，并将顾客引导至 PagBank 付款页面。顾客在那里使用您 PagBank 账户中已启用的付款方式（如信用卡、PIX 或 boleto）付款，然后返回您的商店。付款仅接受巴西雷亚尔（BRL）。只有在 PagBank 报告付款后才会创建订单，因此未完成的付款不会留下未付款的订单。
本模块适合希望使用 PagBank 托管付款页面，并能直接在 PrestaShop 订单页面退款的巴西商店。模块没有店内银行卡表单、不保存银行卡，也不支持订阅、定期付款或分单付款。付款方式和分期付款由您在 PagBank 账户中设置，不能在模块中选择。
主要功能
PagBank 托管付款页面：银行卡数据不会存放在您的服务器上。若商店已有顾客的姓名、电子邮件、巴西电话和 CPF/CNPJ，这些信息会自动填入 PagBank 页面。
仅在 PagBank 确认后才算付款：通过 API 读取付款和 PagBank 订单（状态、以分（centavo）为单位的金额及币种），以核实通知和顾客的返回。签名无效的通知会被拒绝。
无需在 PagBank 中进行任何设置：每笔付款都会附带通知 URL。
金额核对：金额或币种与购物车不符的付款会以附注的形式转入 PagBank payment on hold。顾客支付的分期利息也会计算在内。
清晰的状态：已付款的订单进入 Payment accepted；已生成的 PIX 或 boleto 及审核中的付款进入 Awaiting PagBank payment；之后被拒绝的付款进入 Payment error，被取消的付款进入 Canceled。
避免重复付款：再次付款时会复用未关闭的 PagBank 付款，或停用之前的付款。重复的通知和返回不会创建第二个订单，也不会重复记录付款。
沙盒与正式环境：使用不同的令牌。订单的状态查询和退款始终使用其付款所在的环境。
在订单页面退款：可在 PagBank payment 区块中进行全额或部分退款，金额上限为 PagBank 实际收取的金额，且仅在 PagBank 确认后才会记录。全额退款会将订单设为 Refunded。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。购物车货币为巴西雷亚尔（BRL）。商店需可通过 HTTPS 从互联网访问。需要一个带正式环境令牌的 PagBank 账户，以及用于测试的沙盒令牌。需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。