Skip to content

Commit

Permalink
Merge pull request #25 from marcelo-machado-gn/master
Browse files Browse the repository at this point in the history 
Atualização de compatibilidade
  • Loading branch information
@marcelo-machado-gn
marcelo-machado-gn authored Apr 27, 2023
2 parents f85174e + d856732 commit 2051245
Show file tree
Hide file tree
Showing 359 changed files with 32,079 additions and 22,215 deletions.
67 changes: 34 additions & 33 deletions README.md
View file
Original file line number Diff line number Diff line change
@@ -1,58 +1,59 @@
# Módulo Gerencianet para WHMCS
# Módulo Efí para WHMCS

## Instalação

1. Faça o download da última versão do módulo;
2. Descompacte o arquivo baixado;
3. Copie o arquivo **gerencianet.php** e a pasta **gerencianet**, para o diretório **/modules/gateways** da instalação do WHMCS;
4. Altere as permissões do arquivo copiado utilizando o comando: `chmod 777 modules/gateways/gerencianet.php`
5. Altere as permissões da pasta copiada utilizando o comando: `chmod 777 modules/gateways/gerencianet/ -R`
6. Copie o arquivo **gerencianet.php**, disponível no diretório **callback**, para o diretório **modules/gateways/callback**. Ele deve estar no caminho: *modules/gateways/callback/gerencianet.php*
7. Altere as permissões do arquivo copiado utilizando o comando: `chmod 777 modules/gateways/callback/gerencianet.php`
8. Copie o arquivo **gerencianet.php**, disponível no diretório **hooks**, para o diretório **includes/hooks**. Ele deve estar no caminho *includes/hooks/gerencianet.php*
9. Altere as permissões do arquivo copiado utilizando o comando: `chmod 777 includes/hooks/gerencianet.php`
10. Crie uma pasta na raiz do seu servidor e insira seu certificado na pasta. Vale lembrar que **seu certificado deve estar no formato *.pem***. Você encontra o passo a passo de conversão na sessão: [**Converter certificado .p12 para .pem**](#conversao)
3. Copie o arquivo **efi.php** e a pasta **efi**, para o diretório **/modules/gateways** da instalação do WHMCS;
4. Altere as permissões do arquivo copiado utilizando o comando: `chmod 777 modules/gateways/efi.php`
5. Altere as permissões da pasta copiada utilizando o comando: `chmod 777 modules/gateways/efi/ -R`
6. Copie o arquivo **efi.php**, disponível no diretório **callback**, para o diretório **modules/gateways/callback**. Ele deve estar no caminho: *modules/gateways/callback/efi.php*
7. Altere as permissões do arquivo copiado utilizando o comando: `chmod 777 modules/gateways/callback/efi.php`
8. Copie o arquivo **efi.php**, disponível no diretório **hooks**, para o diretório **includes/hooks**. Ele deve estar no caminho *includes/hooks/efi.php*
9. Altere as permissões do arquivo copiado utilizando o comando: `chmod 777 includes/hooks/efi.php`
10. Crie uma pasta na raiz do seu servidor e insira seu certificado na pasta.

Ao final da instalação, os arquivos do módulo Gerencianet devem estar na seguinte estrutura no WHMCS:
Ao final da instalação, os arquivos do módulo Efí devem estar na seguinte estrutura no WHMCS:

```
includes/hooks/
|- gerencianet.php
|- efi.php
modules/gateways/
|- callback/gerencianet.php
|- gerencianet/
|- gerencianet.php
|- callback/efi.php
|- efi/
|- efi.php
```

### <a id="conversao"></a>Converter certificado .p12 para .pem (Para utilização do PIX)
Todas as requisições devem conter um certificado de segurança que será fornecido pela Gerencianet dentro da sua conta, no formato PFX(.p12). Essa exigência está descrita na integra no [manual de segurança do PIX](https://www.bcb.gov.br/estabilidadefinanceira/comunicacaodados).
### Certificado para utilização da API PIX

Todas as requisições devem conter um certificado de segurança que será fornecido pela Efí dentro da sua conta, no formato PFX(.p12). Essa exigência está descrita na integra no [manual de segurança do PIX](https://www.bcb.gov.br/estabilidadefinanceira/comunicacaodados).

Caso ainda não tenha seu certificado, basta seguir o passo a passo do link a seguir para gerar um novo: [Clique Aqui](https://gerencianet.com.br/artigo/como-gerar-o-certificado-para-usar-a-api-pix/)

Para converter seu certificado de .p12 para .pem, basta utilizar o conversor de certificados disponibilizado pela Gerencianet no link: [Clique aqui](https://pix.gerencianet.com.br/ferramentas/conversorGerencianet.exe)

## Configuração do Módulo

![Tela de Configuração](https://gnetbr.com/r1xCPTzYPc)
1. **Client_Id Produção:** Deve ser preenchido com o client_id de produção de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Minhas Aplicações". Em seguida, selecione sua aplicação criada, conforme é mostrado no [link](https://gnetbr.com/Ske9THqjrO);
2. **Client_Secret Produção:** Deve ser preenchido com o client_secret de produção de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Minhas Aplicações". Em seguida, selecione sua aplicação criada, conforme é mostrado no [link](https://gnetbr.com/Ske9THqjrO);
3. **Client_Id Desenvolvimento:** Deve ser preenchido com o client_id de desenvolvimento de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Minhas Aplicações". Em seguida, selecione sua aplicação criada, conforme é mostrado no [link](https://gnetbr.com/BJe-vIciHd);
4. **Client_Secret Desenvolvimento:** Deve ser preenchido com o client_secret de desenvolvimento de sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Minhas Aplicações". Em seguida, selecione sua aplicação criada, conforme é mostrado no [link](https://gnetbr.com/BJe-vIciHd);
5. **Identificador da conta:** Deve ser preenchido com o identificador da sua conta Gerencianet. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Identificador da Conta", conforme é mostrado no [link](https://gnetbr.com/ryezOK31Qt);
![Tela de Configuração](https://sejaefi.link/BJetA4JvQ3)
1. **Client_Id Produção:** Deve ser preenchido com o client_id de produção de sua conta Efí. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Aplicações". Em seguida, selecione sua aplicação criada, conforme é mostrado no [link](https://gnetbr.com/Ske9THqjrO);
2. **Client_Secret Produção:** Deve ser preenchido com o client_secret de produção de sua conta Efí. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Aplicações". Em seguida, selecione sua aplicação criada, conforme é mostrado no [link](https://gnetbr.com/Ske9THqjrO);
3. **Client_Id Desenvolvimento:** Deve ser preenchido com o client_id de desenvolvimento de sua conta Efí. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Aplicações". Em seguida, selecione sua aplicação criada, conforme é mostrado no [link](https://gnetbr.com/BJe-vIciHd);
4. **Client_Secret Desenvolvimento:** Deve ser preenchido com o client_secret de desenvolvimento de sua conta Efí. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Aplicações". Em seguida, selecione sua aplicação criada, conforme é mostrado no [link](https://gnetbr.com/BJe-vIciHd);
5. **Identificador da conta:** Deve ser preenchido com o identificador da sua conta Efí. Este campo é obrigatório e pode ser encontrado no menu "API" -> "Introdução"->"Identificador da Conta", conforme é mostrado no [link](https://gnetbr.com/ryezOK31Qt);
6. **Usuário administrador do WHMCS:** Deve ser preenchido com o usuário administrador do WHMCS. É necessário utilizar o mesmo usuário que o administrador do WHMCS utiliza para fazer login na área administrativa de sua conta. Este campo é de preenchimento obrigatório;
7. **Desconto do Boleto:** Informe o valor desconto que deverá ser aplicado aos boletos gerados exclusivamente pela Gerencianet. Esta informação é opcional;
8. **Tipo de desconto:** Informe o tipo de desconto (porcentagem ou valor fixo) que deverá ser aplicado aos boletos gerados exclusivamente pela Gerencianet. Esta informação é opcional;
9. **Número de dias para o vencimento do Boleto:** Informe o número de dias corridos para o vencimento do boleto Gerencianet após a cobrança ser gerada. Se o campo estiver vazio, o valor será 0;
10. **E-mail de cobrança - Gerencianet:** Caso seja de seu interesse, habilite o envio de emails de cobrança da Gerencianet para o cliente final;
11. **Configuração de Multa:**Caso seja de seu interesse, informe o valor, em porcentagem, cobrado de multa após o vencimento. Por exemplo: se você quiser 2%, você deve informar 2. Mínimo de 0.01 e máximo de 10. Integer;
7. **Desconto do Boleto:** Informe o valor desconto que deverá ser aplicado aos boletos gerados exclusivamente pela Efí. Esta informação é opcional;
8. **Tipo de desconto:** Informe o tipo de desconto (porcentagem ou valor fixo) que deverá ser aplicado aos boletos gerados exclusivamente pela Efí. Esta informação é opcional;
9. **Número de dias para o vencimento do Boleto:** Informe o número de dias corridos para o vencimento do boleto Efí após a cobrança ser gerada. Se o campo estiver vazio, o valor será 0;
10. **E-mail de cobrança - Efí:** Caso seja de seu interesse, habilite o envio de emails de cobrança da Efí para o cliente final;
11. **Configuração de Multa:** Caso seja de seu interesse, informe o valor, em porcentagem, cobrado de multa após o vencimento. Por exemplo: se você quiser 2%, você deve informar 2. Mínimo de 0.01 e máximo de 10. Integer;
12. **Configuração de Juros:** valor cobrado de juros por dia após a data de vencimento. Por exemplo: se você quiser 0,033%, você deve informar 0.033. Mínimo de 0.001 e máximo de 0.33;
13. **Observação:** Permite incluir no boleto uma mensagem para o cliente;
14. **Sandbox:** Caso seja de seu interesse, habilite o ambiente de testes da API Gerencianet;
15. **Debug:** Neste campo é possível habilitar os logs de transação e de erros da Gerencianet no painel WHMCS;
14. **Sandbox:** Caso seja de seu interesse, habilite o ambiente de testes da API Efí;
15. **Debug:** Neste campo é possível habilitar os logs de transação e de erros da Efí no painel WHMCS;
16. **Chave PIX:** Se utilizado CNPJ, informar sem pontos e espaços, ex. 11111111111121;
17. **Certificado Pix:** Deve ser preenchido com o caminho do certificado salvo em seu servidor no passo 10 da instalação;
18. **Desconto:** Informe o valor de desconto que deverá ser aplicado ao pix gerado exclusivamente pela Gerencianet;
18. **Desconto:** Informe o valor de desconto que deverá ser aplicado ao pix gerado exclusivamente pela Efí;
19. **Validade da Cobrança PIX:** Deve ser informado o período de validade em dias da cobrança PIX;
20. **Mtls:** Entenda os riscos de não configurar o mTLS acessando o link https://gnetbr.com/rke4baDVyd;
20. **Validar mTLS:** Entenda os riscos de não configurar o mTLS acessando o link https://gnetbr.com/rke4baDVyd;
21. **PIX:** Selecione essa opção caso deseje deixar a opção PIX como forma de pagamento;
22. **Boleto:** Selecione essa opção caso deseje deixar a opção boleto como forma de pagamento;
23. **Cartão de Crédito:** Selecione essa opção caso deseje deixar a opção de cartão de crédito como forma de pagamento.
23. **Cartão de Crédito:** Selecione essa opção caso deseje deixar a opção de cartão de crédito como forma de pagamento.
Loading

0 comments on commit 2051245

Please sign in to comment.