IMPORTANTE: Atualize a PGWebLib inferior a 4.1.15.2 até 30/06/24, para evitar a parada do TEF

[Daniel Simoes]

Olá parceiros de TEF do ACBr, temos uma notícia muito importante.

Citar

Os Terminais que fazem uso da PGWebLib em versões inferiores a 4.1.15.2 precisam ser atualizados até 30/06/24, para evitar a parada das transações TEF

 

Isso é necessário, porque a validade do certificado, que está nas versões anteriores, e é responsável pela conexão segura (SSL), irá expirar em 30/06

Nesse tópico esperamos esclarecer as dúvidas de como saber se o seu terminal precisa de atualização, e como aplicar a atualização.

 

1 - Como sei qual a versão que está instalada no cliente ?

A várias formas de identificar isso...

1.1 - Você pode ver as propriedades da DLL no Windows

• Clique com o Botão Direito, sobre o arquivo PGWebLib.dll, e acesse "Propriedades"
• Clique na Aba "Detalhes", e veja a versão:
  

 

1.2 - Você pode notar on Log da PGWebLib, qual é a versão da DLL..Exemplo:

Citar

12:01:43:305 [PGWebLib.c] PW_iNewTransac(0xFC, 0004.0001.0027.0002) <0>

 

2 - Onde baixar a nova DLL PGWebLib, para atualização ?

Humm.. temos duas opções aqui... por favor veja os itens 2.1 e 2.2

2.1 - Se você já Homologou com a Nova DLL Segura versão 4.1.25.x ou superior

Então provavelmente você já sabe que pode achar ela nesse link:
https://paygodev.readme.io/docs/kit-para-atualização-da-documentação

IMPORTANTE: Apenas use essa versão, se você já homologou a mesma

Lembrando que você deve ter os fontes do ACBr atualizados, para usar essa nova DLL Segura...

Se você ainda não conhece a Nova DLL Segura, por favor leia o tópico abaixo:

2.1.1 - Porque é necessário re-homologar para usar a Nova DLL segura ?

Apesar de todos os métodos da DLL permanecerem o mesmo, muito do processo de instalação da DLL mudou, e portanto é importante testar se sua aplicação está 100% compatível

Você deve solicitar a re-homologação no HelpDesk da Setis, abrindo um Ticket em:

https://dev.proj.setis.com.br/servicedesk/customer/portal/16

É importante que todas aplicações sejam re-homologadas com essa nova versão, pois ela que receberá as melhorias no futuro, além de cuidar de atualizações automáticas, evitando assim, problemas de atualização, no futuro. 

Por favor leita o tópico indicado acima, para ter uma melhor compreensão das melhorias criadas de Performance e Segurança, nessa nova DLL

 

2.2 - Usar DLL compatível com série 4.1.15.x, com prazo de validade de certificado estendido.

Essa versão é a que você deve usar, se ainda não testou e homologou a nova DLL Segura (acima)

Você pode achar a PGWebLib 4.1.15.2 nesse Link

Para atualizar usando essa DLL, é bem simples... Basta copiar a nova versão, sobre a antiga...  Provavelmente a PGWebLib.dll estará na mesma pasta do seu .EXE

Observe que existem versões da DLL para o ambiente de Produção e Certificação, além de x86 e x64

Você deve usar a versão x86, para aplicações compiladas em 32 bits (mesmo que o Windows seja 64 bits)

2.1.1 - Qual a validade da PGWebLib 4.1.15.2 ?

Essa versão tem um certificado com validade até Fevereiro de 2025, mas não espere até lá para re-homologar sua aplicação com a Nova DLL segura (leia acima)

 

3 - O que acontecerá se eu não atualizar a PGWebLib ?

Você receberá um erro de conexão SSL, sempre que tentar se comunicar com a PayGo

 

4 - Vou homologar TEF PayGo agora. Qual versão devo usar ?

Você necessariamente, precisa usar a versão mais nova, ou seja a DLL Segura, da série 4.1.25.x ou superior

Você pode achar a versão dessa DLL em:
https://paygodev.readme.io/docs/kit-para-atualização-da-documentação

Observe que essa versão da DLL, possui um instalador e um processo de ativação após a instalação. Isso é necessário, para instalar a DLL na pasta Segura, e instalar os Serviços que irão garantir a segurança da DLL

Todo o processo de instalação e ativação, é descrito no Link acima, na documentação da PayGo

 

5 - Eu já estou homologado na versão nova, 4.1.25.x ou superior. Posso instalar a versão anterior ?

Não é recomendado. Use a nova DLL Segura

Apenas a nova versão, ou seja, a 4.1.25.x ou superior será mantida. Portanto instalar a versão inferior, apenas o obrigará a atualizar manualmente mais uma vez o terminal desse cliente, no futuro

 

6 - Como fazer downgrade da versão 4.1.25.x para a 4.1.15.2 ?

IMPORTANTE: Aplique esse procedimento, apenas se estiver enfrentando problemas com a nova DLL 4.1.25.x...

1. Relate para a Setis, qual o problema encontrado na versão 4.1.25.x.
   https://dev.proj.setis.com.br/servicedesk/customer/portal/16
2. Remova pelo Windows o Client PayGo e Warsaw
3. Reinicie a Máquina, para terminar a desinstalação
4. Baixe a versão 4.1.15.2, nesse link
5. Se você usa o ACBr, certifique-se de ter a última versão dos fontes do ACBr, em sua máquina
6. Copie a DLL do Zip, na mesma pasta do seu .EXE (assim como a DLL antiga)
7. Use a versão correta da DLL
   1. Prod - Produção
   2. x86, para aplicações compiladas em 32 bits (mesmo que o Windows seja 64 bits)
   3. Você deve usar a versão x86, para aplicações compiladas em 32 bits (mesmo que o Windows seja 64 bits)

NOTA: Se seus fontes do ACBr não estiverem atualizados, e ainda existir a variável de ambiente PathPGWebLib, você deve verificar o caminho onde a variável está apontando, e copiar para lá, a DLL

No prompt do CMD, digite o comando "SET", para ver as variáveis de ambiente

Exemplo:
PathPGWebLib=C:\Program Files (x86)\PayGo\PGWebLib\PGWebLib.dll