PHPackages                             gerencianet/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. gerencianet/module-magento2

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

gerencianet/module-magento2
===========================

Gerencianet Payment Gateway

1.0.6(3y ago)3956[1 issues](https://github.com/gerencianet/gn-api-magento2/issues)[1 PRs](https://github.com/gerencianet/gn-api-magento2/pulls)OSL-3.0PHPPHP >=7.3.0

Since Jul 1Pushed 2y ago2 watchersCompare

[ Source](https://github.com/gerencianet/gn-api-magento2)[ Packagist](https://packagist.org/packages/gerencianet/module-magento2)[ RSS](/packages/gerencianet-module-magento2/feed)WikiDiscussions main Synced today

READMEChangelog (6)Dependencies (2)Versions (6)Used By (0)

Gerencianet\_Magento2
=====================

[](#gerencianet_magento2)

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

Módulo de pagamento da Gerencianet, com os métodos de pagamento de Boleto, PIX e Cartão de Crédito.

Pré requisitos:
---------------

[](#pré-requisitos)

- Requer que o PHP esteja no mínimo na versão 7.3.x.
- Requer que o [SDK PHP Gerencianet](https://github.com/gerencianet/gn-api-sdk-php) esteja instalado.

Versões Compativeis:
--------------------

[](#versões-compativeis)

- 2.4.4
- 2.4.5

Instalação
==========

[](#instalação)

> Recomendamos que você possua um ambiente de testes para validar as alterações e atualizações antes de atualiar sua loja em produção. Também que seja feito um **backup** com todas as informações antes de executar qualquer procedimento de atualização/instalação.

Instalação do Módulo Gerencianet:
---------------------------------

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

- Realize o download do módulo e siga os seguintes passos de acordo com a forma que sua loja foi instalada:

### Instalar usando o Composer

[](#instalar-usando-o-composer)

1. Instale via packagist

    - `composer require gerencianet/magento2`
    - Neste momento, podem ser solicitadas suas credenciais de autenticação do Magento. Caso tenha alguma dúvida, há uma descrição de como proceder neste [link da documentação oficial](http://devdocs.magento.com/guides/v2.0/install-gde/prereq/connect-auth.html).
2. Execute os comandos:

    - `bin/magento setup:upgrade`
    - `bin/magento setup:di:compile`
    - `bin/magento cache:clean`

    ### Instalar usando o github

    [](#instalar-usando-o-github)

- Caso sua loja tenha sido criada por meio do clone ou download do projeto magento, siga os seguintes passos:

    1. Extraia o conteúdo do download ZIP e mova o diretório `\Magento2\` para dentro da pasta `Gerencianet` ;
    2. Verifique se está dessa maneira seus diretórios na sua loja `app/code/Gerencianet/Magento2`
    3. Habilite o módulo com o seguinte comando, `bin/magento module:enable Gerencianet_Magento2`
    4. Instale o SDK PHP da Gerencianet utilizando o seguinte comando `composer require gerencianet/gerencianet-sdk-php:3.1.0`
    5. Instale o pacote de log através do comando `composer require laminas/laminas-log`
    6. Execute o comando `bin/magento setup:upgrade`
    7. Execute o comando `bin/magento setup:di:compile`
    8. Execute o comando `bin/magento cache:clean`

Configurações
=============

[](#configurações)

Acesse no Painel Administrativo do Magento no menu lateral clique em **Lojas > Configuração > Clientes > Configurações de Cliente > Opções de Nome e Endereço**. Em *Número de Linhas em Endereço* você deve informar o número **4**, conforme imagem abaixo:

[![FOTO 2](.github/img/2.png)](.github/img/2.png)

**Certifique-se também que o campo de telefone esteja obrigatório.**

Após realizar a configuração do Cliente, acesse no Painel Administrativo do Magento No menu lateral clique em `Lojas`, na sequencia clique em `Configuração`, no sub-menu `Vendas` clique em `Formas de Pagamento`. Será carregada a tela para configurar os meios de pagamentos do site.

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

Como habilitar a Gerencianet
----------------------------

[](#como-habilitar-a-gerencianet)

No primeiro bloco de informação, está a configuração para habilitar ou desabilitar o módulo por completo, marque `Sim` para continuar a configuração.

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

Campos:

- **Ambiente**: Serve para descrever se as transações
- **Identificador da Conta:** Identificador de Conta da Gerencianet
- **Novo Order Status:** Serve para após a finalização da compra definir o Status do pedido.
- **Credenciais de Desenvolvimento ou Produção:** Aqui você informa as suas credenciais como o Client Id e Client Secret.

Em seguida temos as configurações de cartão de crédito, configurações de boleto e configurações de pix.

*OBS: Para que todas as configurações a seguir funcionem, todo o passo a passo anterior deve ter sido seguido.*

### Cartão de Crédito

[](#cartão-de-crédito)

Nesta sessão você tem as configurações de cartão de crédito.

[![FOTO 5](.github/img/5.png)](.github/img/5.png)

Campos:

- **Habilitado:** Serve para habilitar ou desabilitar a funcionalidade de cartão de crédito.
- **Título:** Altera o nome do método de pagamento no checkout.
- **Sort Order:** Ordenação do método de pagamento.

*OBS: Toda configuração de parcelamento, é realizada através do painel do Gerencianet.*

### Pix

[](#pix)

Nesta sessão você tem as configurações de pix.

[![FOTO 6](.github/img/6.png)](.github/img/6.png)

Campos:

- **Habilitado:** Serve para habilitar ou desabilitar a funcionalidade de Pix.
- **Título:** Altera o nome do método de pagamento no checkout.
- **Dias de validade do Pix:** Validade do pix.
- **Certificado Pix:** Certificado gerado no painel do Gerencianet
- **Chave Pix:** Sua chave pix cadastrada no aplicativo do Gerencianet

### Boleto

[](#boleto)

Nesta sessão você tem as configurações de Boleto.

[![FOTO 7](.github/img/7.png)](.github/img/7.png)

Campos:

- **Habilitado:** Serve para habilitar ou desabilitar a funcionalidade de Boletos.
- **Título:** Altera o nome do método de pagamento no checkout.
- **Dias de validade do Boleto:** Validade do Boleto.
- **Multa após o vencimento:** Valor da multa a ser cobrada após o vencimento.
- **Juros após o vencimento:** Valor de juros a ser cobrado.
- **Sort Order:** Ordenação do método de pagamento
- **Instruções no boleto:** Aqui você tem quatro campos que podem ser preenchido com mensagens no boleto, desde que as opções de juros e multa estejam zeradas.

###  Health Score

25

—

LowBetter than 37% of packages

Maintenance13

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 63% of commits — single point of failure

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 ~135 days

Total

5

Last Release

1233d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/744875933e79816c86c35740d8de5845c5003ea7e0d144ee5aacf107aab2b688?d=identicon)[gerencianet](/maintainers/gerencianet)

---

Top Contributors

[![jvoliveiraGN](https://avatars.githubusercontent.com/u/79522328?v=4)](https://github.com/jvoliveiraGN "jvoliveiraGN (17 commits)")[![lucasbayer22](https://avatars.githubusercontent.com/u/49292608?v=4)](https://github.com/lucasbayer22 "lucasbayer22 (5 commits)")[![marcelo-machado-gn](https://avatars.githubusercontent.com/u/106699763?v=4)](https://github.com/marcelo-machado-gn "marcelo-machado-gn (3 commits)")[![guilhermecotaGn](https://avatars.githubusercontent.com/u/75252715?v=4)](https://github.com/guilhermecotaGn "guilhermecotaGn (2 commits)")

---

Tags

billetboletobolixcardcartao-de-creditomagentomagento2magento2-extensionmagento2-modulemodulepixpix-copia-e-colaqrcode

### Embed Badge

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

```
[![Health](https://phpackages.com/badges/gerencianet-module-magento2/health.svg)](https://phpackages.com/packages/gerencianet-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/braintree

Braintree gateway for Omnipay payment processing library

35558.0k3](/packages/omnipay-braintree)

PHPackages © 2026

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