CartModules: PagSeguro Payment Gateway

Accept PagSeguro Payments in Your CS-Cart Store

Integrate PagSeguro (PagBank) — Brazil's leading payment platform — directly into your CS-Cart or Multi-Vendor store. Accept payments via PIX, boleto bancário, credit/debit cards (Visa, Mastercard, Elo, Hipercard, AMEX), and bank debit through a secure hosted checkout flow.

Key Features

• PagSeguro Checkout API v1 — Hosted checkout page with all Brazilian payment methods
• PIX Support — Instant bank transfers, the most popular payment method in Brazil
• Boleto Bancário — Bank slip payments for customers without cards
• Credit & Debit Cards — Visa, Mastercard, Elo, Hipercard, AMEX
• Redirect-Based Flow — No sensitive data touches your server (PCI SAQ A compliant)
• Automatic Order Updates — Checkout status verified on customer return and via server notifications
• Sandbox/Production Toggle — Switch between test and live environments from the admin panel
• Three-Way Status Mapping — Map PAID, pending (IN_ANALYSIS/WAITING), and failed statuses independently
• Bearer Token Authentication — Secure API communication using PagSeguro's official auth
• Idempotent Callbacks — Duplicate callbacks are safely ignored
• CPF Support — Automatically sends customer tax ID when available
• BRL Currency — Native Brazilian Real support with centavo-accurate amounts

Requirements

• CS-Cart or Multi-Vendor 4.x
• PHP 7.1 or higher
• PagSeguro / PagBank merchant account with API Token
• Store currency set to BRL (Brazilian Real)

How It Works

1. Customer selects PagSeguro at checkout and clicks "Place Order"
2. The addon creates a checkout session via the PagSeguro API
3. Customer is redirected to PagSeguro's hosted checkout page
4. Customer chooses their preferred payment method (PIX, boleto, card, etc.)
5. After payment, customer is redirected back to your store
6. The addon verifies the checkout status and updates the order accordingly

Supported Payment Methods

• PIX — Instant bank transfer (settles immediately)
• Boleto bancário — Bank slip (settles in 1-3 business days)
• Credit cards — Visa, Mastercard, Elo, Hipercard, American Express
• Debit cards — Visa, Mastercard, Elo
• Bank debit — Direct bank transfer

Installation

1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
2. Activate the addon and enter the license key
3. Go to Administration > Payment methods and create a new payment method
4. Select "PagSeguro Payment Gateway" as the processor
5. Enter your API Token from the PagSeguro dashboard
6. Configure order status mappings for paid, pending, and failed states
7. Save and test with sandbox mode before going live

Country & Currency

This addon is designed for merchants selling in Brazil. PagSeguro exclusively supports BRL (Brazilian Real). Amounts are converted to centavos for precise calculations. Ensure your store's primary currency is BRL.