概述
VibeFox PagSeguro Gateway 将 OpenCart 3 和 OpenCart 4 连接到 PagBank（PagSeguro）Checkout API，适用于巴西的店铺。在结账的最后一步，顾客点击 Confirm Order，随后跳转到 PagBank 付款页面，并使用其 PagBank 账户中已启用的付款方式付款，例如信用卡、PIX 或 boleto。付款仅接受巴西雷亚尔（BRL）。OpenCart 会在付款前创建订单，但只有在 PagBank 报告付款后，订单才会获得状态，因此未付款的尝试会保持为缺失订单。
本扩展适用于希望使用 PagBank 托管付款页面，并可直接从 OpenCart 订单页面退款的巴西店铺。本扩展在店铺中没有银行卡表单，不支持保存的银行卡、订阅或定期付款，也不支持分账付款。付款方式和分期均以您的 PagBank 账户设置为准。
主要功能
PagBank 付款页面：以 BRL 为订单总额的一次结账。付款页面在 120 分钟后过期。
仅在 PagBank 确认后才算付款：通知和顾客的返回只会触发一次检查。结账、PagBank 订单及其扣款始终使用付款创建时所处环境的令牌，从 PagBank API 读取。
签名通知：当 PagBank 发送 x-authenticity-token 标头时，会使用您的令牌进行核对；无效签名将被拒绝。
金额和币种核对：已扣款金额（不含 PagBank 分期利息）和币种会与订单进行比较。金额不符或取消后的付款，会使订单进入附有备注的审核状态。
Boleto、PIX 和审核：已生成的 boleto 或 PIX，或处于审核中的付款，会使订单进入等待状态，直到 PagBank 报告已付款。
一个购物车，一次付款：顾客再次付款时，已打开的 PagBank 结账会被重新使用，或先被停用。在较早页面上的付款仍然有效，而第二次付款会被标记为需要退款。
在订单页面退款：在订单的 VibeFox PagSeguro Gateway 选项卡中进行全额和部分退款，上限为 PagBank 实际扣款的金额。在 PagBank 控制面板中进行的退款会记录在订单上。
沙盒与正式环境：使用各自独立的令牌。状态检查和退款始终使用付款所在的环境。针对每种情况，您可以设置自己的 OpenCart 订单状态。
要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。下载文件包含两个版本的安装包。您的店铺需使用巴西雷亚尔（BRL）货币。一个 PagBank 账户，包含正式令牌，以及用于测试的沙盒令牌。一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。