概述
VibeFox Pagar.me Gateway 将 OpenCart 3 和 OpenCart 4 连接到 Pagar.me（Stone）Core API v5，适用于巴西的店铺。在结账的最后一步，顾客点击 Confirm Order，随后跳转到 Pagar.me 付款页面，并可使用信用卡、PIX、boleto 或借记卡付款。付款仅接受巴西雷亚尔（BRL）。OpenCart 会在付款前创建订单，但只有在 Pagar.me 确认付款或开具 PIX 或 boleto 之后，订单才会获得状态，因此未付款的尝试会保持为缺失订单。
本扩展适用于希望在同一个托管页面上提供主要本地付款方式，并可直接从 OpenCart 订单页面退款的巴西店铺。本扩展在您的结账流程中没有银行卡表单，不支持保存的银行卡、订阅或定期付款、分期规则、分账付款，也不支持仅授权的银行卡付款。
主要功能
Pagar.me 付款页面：信用卡、PIX、boleto 和借记卡。您可以选择提供哪些付款方式，以及 boleto 的有效天数（1 至 30 天）。
仅在 Pagar.me 确认后才算付款：Webhook 和顾客返回店铺时，只会告知店铺需要核对哪一笔 Pagar.me 订单。随后将使用您的密钥从 Pagar.me API 读取该订单。
金额和币种核对：已收取的金额会与订单总额进行比较。金额不符、boleto 付款不足或取消后的付款，都会使订单进入附有备注的审核状态。
PIX 和 boleto：已开具的 PIX 或 boleto 会使订单进入等待状态，直至 Pagar.me 确认付款。已过期的 PIX 或 boleto 会将订单设为失败状态。
一个购物车，一次付款：顾客再次付款时，已打开的付款页面会被重新使用，或先在 Pagar.me 上关闭。同一购物车的第二次付款会被标记为需要退款。
在订单页面退款：在订单的 VibeFox Pagar.me Gateway 选项卡中，可对银行卡和 PIX 付款进行全额或部分退款，退款金额上限为 Pagar.me 实际收取的金额。在 Pagar.me 上进行的退款和拒付会记录在订单中。
测试与正式环境：测试和正式环境使用各自独立的密钥。状态检查和退款始终使用付款创建时所处模式的密钥。
您自己的订单状态：为已付款订单、等待中的 PIX 或 boleto、审核中的付款、失败的付款以及退款选择对应的 OpenCart 状态。
系统要求
OpenCart 3.0.x（已在 3.0.5.0 上测试）或 OpenCart 4.0.2 及更高版本（已在 4.1.0.3 上测试），PHP 8.0 或更高版本。一个下载包同时包含两个版本的安装包。您的店铺需使用巴西雷亚尔（BRL）货币。一个 Pagar.me 账户，同时拥有测试和正式环境的密钥以及一个 Webhook。一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。