PHPackages                             paghiper/module-magento2 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Payment Processing](/categories/payments)
4. /
5. paghiper/module-magento2

ActiveMagento2-module[Payment Processing](/categories/payments)

paghiper/module-magento2
========================

Módulo Oficial do PagHiper para Magento &gt; 2.3.x com emissão de boletos registrados com retorno automático.

1.1.4(2y ago)03605[2 issues](https://github.com/paghiper/Modulo-PagHiper-Pix-Magento-2.3.X-e-2.4.X/issues)[1 PRs](https://github.com/paghiper/Modulo-PagHiper-Pix-Magento-2.3.X-e-2.4.X/pulls)OSL-3.0PHP

Since Nov 17Pushed 4mo ago1 watchersCompare

[ Source](https://github.com/paghiper/Modulo-PagHiper-Pix-Magento-2.3.X-e-2.4.X)[ Packagist](https://packagist.org/packages/paghiper/module-magento2)[ RSS](/packages/paghiper-module-magento2/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (3)DependenciesVersions (3)Used By (0)

Módulo de Integração [PagHiper](https://www.paghiper.com/)
==========================================================

[](#módulo-de-integração-paghiper)

Instalação
----------

[](#instalação)

> ⚠️ Recomendamos fortemente o uso de um ambiente de testes para validar alterações e atualizações antes de aplicá-las na sua loja em produção. Além disso, realize sempre um backup completo com todas as informações antes de executar qualquer procedimento de atualização ou instalação.

### Versões Compatíveis

[](#versões-compatíveis)

- 2.3.X
- 2.4.0
- 2.4.1
- 2.4.2
- 2.4.3
- 2.4.4
- 2.4.5
- 2.4.6
- 2.4.8

### Requisitos:

[](#requisitos)

- PHP na versão mínima 7.0.X.
- O endereço do cliente deve conter pelo menos 3 linhas.

### Instalação do Módulo PagHiper

[](#instalação-do-módulo-paghiper)

- Faça o download do módulo e siga os passos conforme o modo de instalação da sua loja:

    #### [Paghiper Module](https://github.com/paghiper/Modulo-PagHiper-Pix-Magento-2.3.X-e-2.4.X)

    [](#paghiper-module)

### Instalação via Composer

[](#instalação-via-composer)

1. Instale pelo Packagist executando:

- `composer require paghiper/module-magento2`
    - Se solicitado, informe suas credenciais de autenticação do Magento. [Adobe Documentation](http://devdocs.magento.com/guides/v2.0/install-gde/prereq/connect-auth.html).

2. Execute os comandos abaixo para concluir a instalação:

- `bin/magento setup:upgrade`
- `bin/magento setup:di:compile`
- `bin/magento setup:static-content:deploy -f`

### Instalação via GitHub (Clone ou Download do Projeto Magento)

[](#instalação-via-github-clone-ou-download-do-projeto-magento)

Se sua loja foi criada clonando ou baixando o projeto Magento, siga estas etapas:

1. Baixe o repositório como arquivo .zip
2. Dentro do diretório de instalação da sua loja, crie a pasta com seguinte estrutura: app/code/Paghiper/Magento2
3. Extraia o conteúdo do arquivo .zip nessa pasta
4. Execute para habilitar o módulo: bin/magento module:enable Paghiper\_Magento2 --clear-static-content.
5. Execute o comando bin/magento setup:upgrade.
6. Execute o comando bin/magento setup:di:compile.
7. Execute o comando bin/magento setup:static-content:deploy -f.
8. Execute o comando bin/magento cache:clean.

### Configurações

[](#configurações)

Configurar Endereço no Painel Administrativo do Magento É importante ajustar a quantidade de linhas permitidas no endereço do cliente para que a integração funcione corretamente. Para isso seguimos os seguintes passos:

1. No painel administrativo do Magento, clique em `Stores`
2. Agora vamos em `Configuration`.
3. Proximo passo é clicar em `Customers`, depois `Customer Configuration`.
4. Acesse a opção `Name and Address Options`.
5. Em `Number of Lines in Address`, configure para 4
6. Agora basta salvar as alterações

Essa configuração ajusta quantas linhas são usadas no formato de endereço, permitindo que você inclua os campos obrigatórios para os endereços de seus clientes

[![FOTO 1](.github/img/pt_br/01.png)](.github/img/pt_br/01.png)

Configurar Métodos de Pagamento no Magento Após configurar os dados do cliente, siga para a configuração dos métodos de pagamento:

1. No painel administrativo, vá em `Stores`
2. Clique em `Configuration`.
3. No submenu vamos em `Sales`, e clicamos em `Payment Methods`.

Isso carregará a tela onde você poderá configurar os métodos de pagamento para o seu site.

 [![](.github/img/pt_br/02.png)](.github/img/pt_br/02.png)

### Como habilitar o PagHiper na sua loja

[](#como-habilitar-o-paghiper-na-sua-loja)

No primeiro bloco de informações dentro da seção PagHiper, você encontrará a opção para ativar ou desativar o módulo:

- ApiKey

    - Insira sua apiKey fornecida pela PagHiper.
- Token

    - Token insira seu token gerado na PagHiper
- Dias de validade

    - Esta opção é utilizada tanto para boleto quanto para Pix. Um valor inteiro em `dias` é usado para especificar o período de validade do pagamento.
- Faturar Após Pagamento Confirmado?

    - Ative para que a nota fiscal seja gerada somente após a confirmação do pagamento.

[![FOTO 3](.github/img/pt_br/03.png)](.github/img/pt_br/03.png)

Logo abaixo, você encontrará duas opções: uma para configuração de pagamento com Pix e outra com boleto.

NOTA: Para que todas as configurações a seguir funcionem, todas as etapas anteriores devem ter sido seguidas.

### Configurações do Boleto

[](#configurações-do-boleto)

- **Ativado**
- Ativa ou desativa o boleto como método de pagamento.
- **Percentual de Penalidade por Atraso no Pagamento**
- Adiciona um valor percentual como penalidade por atraso no pagamento.
- **Juros por Atraso no Pagamento**
- Determina se serão aplicados juros por atraso no pagamento e o valor.
- **Número de Dias de Desconto**
- O número de dias antes do qual um desconto é concedido sobre o valor informado.
- **Valor do Desconto por Pagamento Antecipado**
- O valor do desconto que será concedido ao boleto.
- **Número de Dias Após o Vencimento**
- O número de dias que o cliente ainda pode pagar o boleto após a data de vencimento.

    [![FOTO 4](.github/img/pt_br/04.png)](.github/img/pt_br/04.png)

### Configurações do Pix

[](#configurações-do-pix)

- **Ativado**
- Ativa ou desativa o método de pagamento Pix. [![FOTO 5](.github/img/pt_br/05.png)](.github/img/pt_br/05.png)
- **Expiração**
- Tempo de expiração do pagamento Pix em minutos. Se não for fornecido, o valor do campo `Dias de Validade` será usado.

### Observação

[](#observação)

- É importante ajustar a duração em que um pedido com pagamento pendente permanece aberto além da configuração padrão do Magento. O tempo em minutos definido na imagem abaixo deve ser maior que o período de validade de um pedido feito por boleto ou Pix. Por exemplo, 10080 minutos equivalem a 7 dias.
- Caminho: `Configuração` -&gt; `Vendas` -&gt; `Configurações de Pedidos Cron` -&gt; `Tempo de Expiração do Pedido com Pagamento Pendente (minutos)`[![FOTO 6](.github/img/pt_br/06.png)](.github/img/pt_br/06.png)

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance52

Moderate activity, may be stable

Popularity15

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~908 days

Total

2

Last Release

733d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/957b25409fb16372186bac4df127bd1e55fbb364cae5ff41d57b5367b86a4365?d=identicon)[paghiper](/maintainers/paghiper)

---

Top Contributors

[![magento-paghiper](https://avatars.githubusercontent.com/u/79910070?v=4)](https://github.com/magento-paghiper "magento-paghiper (9 commits)")[![weslleypg](https://avatars.githubusercontent.com/u/27303585?v=4)](https://github.com/weslleypg "weslleypg (8 commits)")[![LucasPereira762xi](https://avatars.githubusercontent.com/u/26752169?v=4)](https://github.com/LucasPereira762xi "LucasPereira762xi (1 commits)")[![vitorPagHiper](https://avatars.githubusercontent.com/u/89871623?v=4)](https://github.com/vitorPagHiper "vitorPagHiper (1 commits)")

### Embed Badge

![Health badge](/badges/paghiper-module-magento2/health.svg)

```
[![Health](https://phpackages.com/badges/paghiper-module-magento2/health.svg)](https://phpackages.com/packages/paghiper-module-magento2)
```

###  Alternatives

[omnipay/paypal

PayPal gateway for Omnipay payment processing library

3156.8M53](/packages/omnipay-paypal)[eduardokum/laravel-boleto

Biblioteca com boletos para o laravel

626351.9k2](/packages/eduardokum-laravel-boleto)[tbbc/money-bundle

This is a Symfony bundle that integrates moneyphp/money library (Fowler pattern): https://github.com/moneyphp/money.

1961.9M](/packages/tbbc-money-bundle)[2checkout/2checkout-php

2Checkout PHP Library

83740.3k2](/packages/2checkout-2checkout-php)[smhg/sepa-qr-data

Generate QR code data for SEPA payments

61717.2k5](/packages/smhg-sepa-qr-data)[omnipay/dummy

Dummy driver for the Omnipay payment processing library

271.2M33](/packages/omnipay-dummy)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
