VibeFox PagSeguro for Adobe Commerce

Overview

VibeFox PagSeguro Gateway adds PagBank (formerly PagSeguro) payments through the PagBank Checkout API to Magento Open Source and Adobe Commerce. The customer chooses PagBank at the payment step and clicks Place Order. Magento places the order in Pending Payment, and the customer goes to the PagBank payment page, pays there with the methods enabled in your PagBank account, such as credit card, PIX or boleto, and comes back to your store. Payments are in Brazilian Real (BRL) only. The order is invoiced only after PagBank confirms the payment, and the order e-mail is sent only then.

It suits Brazilian stores that want PagBank's hosted payment page with online refunds from the Magento credit memo. The module has no on-site card form, no saved cards, no subscriptions or recurring payments, no split payments and no separate capture of authorized payments. Payment methods and installments are those configured in your PagBank account; they are not chosen in the module. PagBank is not offered for orders created in the Admin.

Key features

Hosted PagBank page: no card data on your server. The customer's name, e-mail, a Brazilian phone number and the CPF/CNPJ from the VAT number of the billing address are filled in on the PagBank page when the order has them.

Paid only when PagBank confirms: notifications and the customer's return are checked by reading the checkout and the PagBank order from the API: status, amount in centavos and currency. Notifications with an invalid signature are rejected.

Nothing to configure in PagBank: the notification URL is sent with every payment and is shown on the settings page.

Amount check: a payment whose amount or currency differs from the order total puts the order On Hold with a note and without an invoice. Installment interest paid by the buyer is taken into account.

PIX and boleto: a generated PIX or boleto and payments in analysis keep the order in Pending Payment with a note; the order is invoiced as soon as PagBank reports the payment.

No double payment: a new payment attempt for the same cart is started only after the previous PagBank checkout is deactivated. Repeated notifications and returns never invoice an order twice.

Sandbox and production: separate tokens. Status checks and refunds of an order always use the environment in which its payment was made.

Online refunds with Credit Memo: full and partial refunds through the standard Magento Credit Memo of the invoice with Refund, recorded only when PagBank confirms them. Refunds made in the PagBank dashboard are noted on the order.

Standard Magento settings: all settings are on the standard Payment Methods configuration page, with encrypted tokens, the notification URL shown on the page, countries and minimum and maximum order totals, and an optional log without tokens or customer data.

Requirements

Magento Open Source or Adobe Commerce 2.4.6 to 2.4.9 (your own server or Adobe Commerce on cloud infrastructure; not Adobe Commerce as a Cloud Service), PHP 8.1 to 8.4. Brazilian Real (BRL) as the order currency. A store reachable from the internet over HTTPS. A PagBank account with a production token, and a sandbox token for tests. A VibeFox license key from vibefox.net (one key per domain).