Overview
The PagSeguro extension integrates Magento 2 with PagSeguro, the leading online payment platform in Brazil operated by UOL. It supports credit cards, bank transfers, payment slips (boleto), and PagSeguro account balance payments. Because all transactions are processed on PagSeguro’s secure servers, no SSL certificate is required on the merchant’s side.
The extension targets Magento 2 merchants selling to Brazilian customers, or international merchants accepting Brazilian payment methods. An active PagSeguro merchant account is required.
How It Works
The extension offers two checkout experiences: redirect sends the customer to PagSeguro’s PCI Level 1 compliant hosted page to complete payment; lightbox overlays the payment form on the storefront page while processing the transaction in PagSeguro’s secure environment. Neither option ever stores card data on the Magento server.
After payment, PagSeguro sends transaction notifications back to the store, which the extension processes to update order status and create invoices or credit memos automatically.
Features
- Redirect checkout — customer completes payment on PagSeguro’s hosted page
- Lightbox checkout — payment form overlays the storefront without a page redirect
- PCI SAQ A compliance — no card data touches the Magento server
- Card support — Visa, Mastercard, Diners, Amex, Hipercard, Aura, Elo, PLENOCard, PersonalCard, Brasilcard, FORTBRASIL, CARDBAN, VALECARD, and Cabal
- Instalment support — customers can split payments across instalments
- Authorise and Capture / Authorise Only — choose the flow that suits your fulfilment process
- Transaction notifications — order status updated automatically via PagSeguro callbacks
- MOTO orders — create orders and capture payments from the Magento Admin
- Partial invoices and refunds — supports multi-settlement and partial credit memos
- AVS / CVV results — authorisation details visible on the Order View page
- Transaction reporting — view, manage, and export all transactions to CSV or Excel
- Multi-store, multi-currency, multi-account — single installation covers multiple storefronts
- English and Portuguese (pt_BR) language packs
Use Case
PagSeguro is a prerequisite for selling to Brazilian consumers — it is the dominant local payment method and the only practical way to accept boleto and Brazilian-issued cards that are not processed internationally. Merchants expanding into Brazil or running dedicated Brazilian storefronts need a native PagSeguro integration rather than a generic gateway that does not support local payment types.
Benefits
- Accept the full range of Brazilian payment methods without a separate gateway
- PCI SAQ A scope — no card data on the Magento server simplifies compliance
- Automatic notification processing keeps order status in sync without manual intervention
- Full order lifecycle (invoice, refund, cancel) managed from the Magento Admin