概述
VibeFox Pagar.me Gateway 将 PrestaShop 连接到 Pagar.me（Stone）Core API v5，适用于巴西的店铺。在付款步骤中，顾客选择 Pagar.me，会被转到 Pagar.me 付款页面，可使用信用卡、PIX、boleto 或借记卡付款。银行卡信息绝不会经过您的店铺。付款仅支持巴西雷亚尔（BRL）。只有在 Pagar.me 确认付款或生成 PIX 或 boleto 之后，订单才会创建，因此被放弃的付款不会留下未付款的订单。
适合希望在一个托管页面上提供主要本地付款方式、并能在 PrestaShop 订单页面中直接退款的巴西店铺。本模块在您的结账流程中没有银行卡表单，不支持保存银行卡、订阅或定期付款、分期规则、拆分付款、仅授权的银行卡付款，也不支持 Pagar.me Hub 集成。
主要功能
Pagar.me 付款页面：信用卡、PIX、boleto 和借记卡。您可以选择提供哪些付款方式，以及 boleto 的有效天数（1 至 30 天）。
仅在 Pagar.me 确认后标记为已付款：Webhook 和顾客的返回只会告诉店铺需要核对哪个 Pagar.me 订单。之后，系统会使用您的密钥通过 Pagar.me API 读取该订单。
金额与货币核对：已付费用的金额会与购物车总额进行比较。金额不符、boleto 付款不足或取消后收到的付款都会使订单进入 Pagar.me payment on hold 状态并附带备注。
PIX 和 boleto：已生成的 PIX 或 boleto 会使订单进入 Awaiting Pagar.me payment 状态，直到 Pagar.me 确认付款；已过期的付款会使订单进入 Payment error 状态。
安全的重复付款：顾客再次付款时，会复用仍然打开的付款页面，或先在 Pagar.me 中将其关闭。来自旧页面的付款仍会与购物车匹配，而第二笔付款会被标记为需要退款。
订单页面退款：在 Pagar.me payment 区块中可对银行卡和 PIX 付款进行全额或部分退款，退款上限为 Pagar.me 实际收取的金额。在 Pagar.me 中完成的退款和拒付会显示在订单上。
测试与正式：测试和正式模式使用各自独立的密钥。状态查询和退款始终使用付款创建时所处模式的密钥。
订单页面的 Pagar.me 区块：Pagar.me 订单、付款方式、状态、已付和已退金额、退款记录以及订单的 Pagar.me 备注。可选的日志，不记录密钥或顾客数据。
系统要求
PrestaShop 8.0 至 9.x，PHP 8.0 或更高版本。店铺货币为巴西雷亚尔（BRL）。需要一个 Pagar.me 账户，其中包含测试和正式的密钥，以及一个 Webhook。需要一个来自 vibefox.net 的 VibeFox 许可证密钥（每个域名一个密钥）。