# pagbank/payment-magento

> PagBank - Payment for Magento and Adobe

`composer require pagbank/payment-magento`

Canonical URL: https://packagento.com/pagbank/payment-magento

## At a glance

- **Vendor**: pagbank (https://packagento.com/pagbank.md)
- **Latest version**: 101.1.3 — released 2026-02-26
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/pagbank/payment-magento and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require pagbank/payment-magento:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

PagBank - Payment for Magento and Adobe

## README

Módulo para pagamento em Magento e Adobe Commerce.

### Badges

[![Magento Coding Quality](https://github.com/pagseguro/payment-magento/actions/workflows/magento-coding-quality.yml/badge.svg)](https://github.com/pagseguro/payment-magento/actions/workflows/magento-coding-quality.yml)
[![Magento Mess Detector](https://github.com/pagseguro/payment-magento/actions/workflows/mess-detector.yml/badge.svg)](https://github.com/pagseguro/payment-magento/actions/workflows/mess-detector.yml)

### Melhores taxas do mercado

Conheça e compare nossos planos promocionais

| Recurso | Magento e Adobe Commerce - Account Profile | Magento e Adobe Commerce - D14 | Magento e Adobe Commerce - D30 |
|---------|------------------------------------------|-------------------------------|-------------------------------|
| Vantagens | - Ideal para quem fatura acima de R$ 300.000 <br>- Taxas e recebimentos personalizados<br>- Solicite sua proposta personalizada [aqui](https://pagseguro.uol.com.br/campanhas/contato/?parceiro=aec) | - Ideal para quem precisa de maior fluxo de caixa <br>- Taxas reduzidas | - Ideal para quem tem maior fluxo de caixa <br>- As melhores taxas do mercado |
| Tipo de Recebimento | Conforme definido em sua conta | Receba em até 14 dias | Receba em até 30 dias |
| Taxas* | Conforme definido em sua conta |**Cartão:** <br>-Com taxa de 3,97%<br><br>**Pix:** <br>- Com taxa de 0,99%.<br>-Com recebimento imediato.<br><br>**Boleto:** <br>- Com taxa fixa de R$ 2,99.<br>- Com recebimento em até 2 dias úteis.| **Cartão:** <br>-Com taxa de 3.05%. <br><br>**Pix:** <br>- Com taxa de 0,99%.<br>-Com recebimento imediato.<br><br>**Boleto:** <br>- Com taxa fixa de R$ 2,99.<br>- Com recebimento em até 2 dias úteis. |

\* As taxas aqui anunciadas podem sofrer variações, consulte nossa página para os valores atualizados.

### Recursos

Desenvolvida no padrão Gateway, nosso módulo irá oferecer uma perfeita integração com a sua loja.

Receba e gerencie pagamentos com a pioneira e líder de mercado no Brasil!

#### Cartão de Crédito, Débito e Cofre (Vault) <img src="view/base/web/images/cc/ae.svg" align="right" width="35"/> <img src="view/base/web/images/cc/au.svg" align="right" width="35"/> <img src="view/base/web/images/cc/dn.svg" align="right" width="35"/> <img src="view/base/web/images/cc/elo.svg" align="right" width="35"/> <img src="view/base/web/images/cc/hc.svg" align="right" width="35"/> <img src="view/base/web/images/cc/mc.svg" align="right" width="35"/> <img src="view/base/web/images/cc/vi.svg" align="right" width="35"/>

Receba e gerencie transações de cartão de crédito em sua loja.

Principais Recursos:

- Método transparente
- Autenticação 3DS
- Salvamento de cartão via api de Zero Dollar
- AntiFraude aprimorado com revisão manual
- Captura automatizada ou tardia
- Reembolso online total ou parcial
- Negação de Pagamento diretamente no checkout
- Personalização de regras para juros e parcelamento
- Informação ao cliente do juros cobrados com atualização do total do pedido
- Consolidação de status (cancelamento e confirmação de pagamento automática)

#### 2 Cartões <img src="view/base/web/images/two-cc/logo.svg" align="right" width="35"/>

Receba com pedidos que usem 2 cartões de crédito.

Principais Recursos:

- Método transparente
- Autenticação 3DS
- AntiFraude aprimorado com revisão manual
- Captura automatizada ou tardia
- Negação de Pagamento diretamente no checkout
- Personalização de regras para juros e parcelamento
- Informação ao cliente do juros cobrados com atualização do total do pedido
- Consolidação de status (cancelamento e confirmação de pagamento automática)


#### Pix <img src="view/base/web/images/pix/logo.svg" align="right" width="35"/>

Receba e gerencie transações por Pix totalmente integrado a sua conta do PagBank.

Principais Recursos:

- Método transparente
- AntiFraude aprimorado com revisão manual
- Reembolso online total ou parcial
- Consolidação de status (cancelamento e confirmação de pagamento automática)

#### Boleto Bancário <img src="view/base/web/images/boleto/logo.svg" align="right" width="35"/>

Receba e gerencie transações por Boleto totalmente integrado a sua conta do PagBank.

Principais Recursos:

- Método transparente
- AntiFraude aprimorado com revisão manual
- Reembolso online total ou parcial
- Consolidação de status (cancelamento e confirmação de pagamento automática)

### Instalação e Configuração

Visite nossa [Wiki](../../wiki) e veja como é fácil instalar e configurar o módulo.

### License

[Open Source License](../../LICENSE)

## Recent Versions

| Version | Released |
|---|---|
| 101.1.3 | 2026-02-26 |
| 101.1.2 | 2025-12-10 |
| 101.1.1 | 2025-10-20 |
| 100.3.1 | 2025-06-11 |
| 100.2.50 | 2025-06-10 |
| 100.2.49 | 2025-04-25 |
| 100.1.48 | 2024-12-05 |
| 100.0.48 | 2024-12-05 |
| 100.2.48 | 2024-12-05 |
| 100.0.47 | 2024-12-04 |

Showing 10 of 135 versions. Full release history on https://packagento.com/pagbank/payment-magento.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| ext-json | * |
| magento/framework | * |
| magento/module-backend | * |
| magento/module-checkout | * |
| magento/module-config | * |
| magento/module-customer | * |
| magento/module-directory | * |
| magento/module-eav | * |
| magento/module-payment | * |
| magento/module-sales | * |
| magento/module-theme | * |
| magento/module-ui | * |
| magento/module-vault | * |
| php | ~8.1.0\|\|~8.2.0\|\|~8.3.0\|\|~8.4.0 |

### Require (dev)

| Package | Constraint |
|---|---|
| magento/magento-coding-standard | * |
| phpmd/phpmd | ^2.13 |
| phpstan/extension-installer | ^1.2 |
| phpstan/phpstan | ^1.6.8 |
| phpunit/phpunit | ^9.0 |

## Quality

Latest release (101.1.3) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | Pass | – |
| 2.4.9 | – | – | 1 | not tested |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 199 | 199 warnings (ruleset: Magento2) — 191 auto-fixable with phpcbf |
| PHPMD | Pass | 0 |  |
| Cpd | Warning | 10 | 10 duplicated chunks spanning 1182 total lines (min-lines=5, min-tokens=70) |
| Composer validate | Info | 12 | valid; 12 advisory notes (composer validate --strict) |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 413 | 413 | – | – |
| 2.4.8 | – | 413 | 413 | – |
| 2.4.9 | – | – | 414 | N/A |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["pagbank/payment-magento"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

pagbank is a Magento 2 vendor on Packagento. See https://packagento.com/pagbank.md for their full catalogue.

