VibeFox Pagar.me for PrestaShop

Overview

VibeFox Pagar.me Gateway connects PrestaShop to the Pagar.me (Stone) Core API v5 for shops in Brazil. At the payment step the customer chooses Pagar.me, is sent to the Pagar.me payment page and pays by credit card, PIX, boleto or debit card. Card data never touches your shop. Payments are in Brazilian Real (BRL) only. The order is created only after Pagar.me confirms the payment or issues a PIX or boleto, so abandoned payments leave no unpaid orders.

It suits Brazilian shops that want the main local payment methods on one hosted page, with refunds from the PrestaShop order page. The module has no card form inside your checkout, no saved cards, subscriptions or recurring payments, no installment rules, no split payments, no authorize-only card payments and no Pagar.me Hub integration.

Key features

Pagar.me payment page: credit card, PIX, boleto and debit card. You choose which methods are offered and how many days a boleto is valid (1 to 30).

Paid only when Pagar.me confirms: the webhook and the customer's return only tell the shop which Pagar.me order to check. The order is then read from the Pagar.me API with your secret key.

Amount and currency check: the paid charges are compared with the cart total. A difference, an underpaid boleto or a payment after cancellation puts the order in Pagar.me payment on hold with a note.

PIX and boleto: an issued PIX or boleto creates the order in Awaiting Pagar.me payment until Pagar.me confirms the payment. An expired one sets the order to Payment error.

Safe retries: when the customer pays again, the open payment page is reused or closed at Pagar.me first. A payment of an older page is still matched to the cart, and a second payment is flagged for a refund.

Refunds from the order page: full and partial refunds of card and PIX payments in the Pagar.me payment block, up to the amount Pagar.me actually took. Refunds and chargebacks made at Pagar.me are shown on the order.

Test and live: separate test and live secret keys. Status checks and refunds always use the key of the mode the payment was created in.

Pagar.me block on the order page: the Pagar.me order, payment method, status, paid and refunded amounts, refund history and the Pagar.me notes of the order. Optional log without keys or customer data.

Requirements

PrestaShop 8.0 to 9.x, PHP 8.0 or later. Shop currency Brazilian Real (BRL). A Pagar.me account with the test and live secret keys and a webhook. A VibeFox license key from vibefox.net (one key per domain).