Resumo do que será ensinado
Neste documento você vai aprender, em linguagem simples, como integrar o ConnectTEF a um PDV que já utiliza o SiTef via DLL (TEF dedicado). O material detalha todos os passos necessários, desde o download das DLLs, remoção de versões antigas, cópia dos novos arquivos, acesso ao diretório do ConnectTEF e criação do arquivo config.txt com o nome do processo do seu PDV.
Segue um Vídeo explicativo do processo
Detalhamento do uso correto
Com este guia, você deve ser capaz de preparar o ambiente Windows e o PDV que já usa SiTef, substituindo as DLLs corretas e configurando o arquivo config.txt para que o ConnectTEF reconheça o processo do PDV. Ao final, o seu sistema estará compatível com o ConnectTEF utilizando a integração via SiTef, sem necessidade de mudanças profundas no código do PDV.
Segue o detalhamento de como realizar a Integração Sitef (TEF Dedicado via DLL)
Pré-requisitos e contexto da integração
Esta integração é destinada a PDVs que já utilizam o SiTef via DLL (TEF dedicado) em ambiente Windows.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
O objetivo é permitir que esse PDV passe a operar com o ConnectTEF mantendo o mesmo modelo de TEF dedicado, apenas ajustando as DLLs e a configuração.
Pré-requisito importante:
O gerenciador padrão do SiTef deve estar instalado e configurado previamente. Sem isso, a configuração descrita aqui não será possível.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Ponto de atenção
Antes de seguir este passo a passo, confirme com sua equipe técnica ou com o cliente que o gerenciador SiTef está funcional (testes básicos de transação já realizados).
Passo 1 – Baixar as interfaces (DLLs) necessárias
Acesse a documentação do ConnectTEF na seção TEF Dedicado (DLL) / SiTef.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Baixe os seguintes arquivos:
CliSiTef32I.dll.
InterfaceConnectTEF.dll nas versões compatíveis com seu ambiente:
X64.
X86.
Win32.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Pontos de atenção
Certifique‑se de baixar a versão correta da InterfaceConnectTEF.dll de acordo com a arquitetura do sistema (32 ou 64 bits).
Salve os arquivos em uma pasta temporária (por exemplo, Downloads ou C:\Temp) para facilitar o uso nos passos seguintes.
Passo 2 – Remover DLLs antigas do sistema
No Windows, utilize o Explorador de Arquivos para navegar até os diretórios abaixo e remover qualquer versão antiga da DLL CliSiTef32I.dll:
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
C:\Windows
C:\Windows\System32
C:\Windows\SysWOW64
Verifique em cada pasta se existe o arquivo CliSiTef32I.dll:
Caso exista, apague o arquivo.
Caso não exista, apenas siga para o próximo diretório.
Ponto importante
Essa remoção é crítica para evitar conflitos entre versões antigas e a nova interface do ConnectTEF.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Se houver dúvida sobre permissões:
Execute o procedimento com um usuário administrador.
Caso o sistema bloqueie, peça suporte à área de TI do cliente.
Passo 3 – Copiar as novas DLLs para o diretório do Windows
Após apagar as DLLs antigas, copie os arquivos baixados no Passo 1 para o diretório padrão do Windows:
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
C:\Windows
Arquivos que devem ser copiados:
CliSiTef32I.dll (nova versão).
InterfaceConnectTEF.dll (na variante adequada ao ambiente: X64/X86/Win32).
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Certifique‑se de que:
Os arquivos foram copiados sem erro.
Estão presentes em C:\Windows.
Pontos de atenção
Em ambientes 64 bits, normalmente:
System32 é usado para DLLs 64 bits.
SysWOW64 para DLLs 32 bits.
A documentação orienta copiar para C:\Windows, que é suficiente para o cenário descrito. Caso sua equipe possua uma política específica, alinhe antes de mover DLLs.
Passo 4 – Acessar o diretório de instalação do ConnectTEF
Na área de trabalho (Desktop), localize o atalho Connect TEF.
Clique com o botão direito sobre o atalho.
Selecione a opção “Abrir local do arquivo”.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
O Windows irá abrir o diretório onde o ConnectTEF está instalado, geralmente algo como:
C:\Program Files\Connect TEF\
ou caminho equivalente, dependendo da instalação.
Ponto de atenção
Esse diretório é importante porque é aqui que você irá criar o arquivo de configuração (config.txt) que conecta o processo do PDV ao ConnectTEF.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Passo 5 – Criar e configurar o arquivo config.txt
Dentro do diretório que foi aberto no passo anterior (instalação do ConnectTEF), faça o seguinte:
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Criar arquivo de texto:
Clique com o botão direito em uma área vazia da pasta.
Escolha Novo → Documento de Texto.
Nomeie o arquivo como config.txt (atenção para não deixar .txt.txt).
Editar o arquivo config.txt:
Abra o arquivo com o Bloco de Notas ou outro editor de texto simples.
Adicione a linha abaixo:
PROCESS_NAME=<nome-do-processo-do-pdv>
Substitua <nome-do-processo-do-pdv> pelo nome real do executável do seu PDV que já usa o SiTef.
Exemplo:
Se o executável do PDV for PDVSuper.exe, a linha ficará:
PROCESS_NAME=PDVSuper.exe
Pontos de atenção
O valor em PROCESS_NAME deve ser exatamente o nome do executável do PDV, incluindo extensão .exe quando aplicável.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Se houver dúvida:
Localize o atalho do PDV na área de trabalho.
Clique com o botão direito → Propriedades → verifique o campo Destino para encontrar o nome exato do arquivo executável.
Validação básica após configuração
Após concluir os passos de DLL + config.txt, você deve validar se o PDV está realmente operando com o ConnectTEF via SiTef:
Reinicie o PDV (feche e abra novamente).
Realize uma transação de teste (por exemplo, uma venda de pequeno valor) usando a forma de pagamento TEF:
Observação:
O fluxo visual do pagamento continuará sendo o do SiTef/TEF dedicado já conhecido pelo operador.
Internamente, o ConnectTEF agora está recebendo e gerenciando essas transações.
Verifique:
Se a transação é autorizada com sucesso.
Se os registros de NSU e autorização aparecem conforme esperado.
Se não há mensagens de erro relacionadas a TEF/dll.
Ponto importante
Caso ocorram erros:
Confirme se CliSiTef32I.dll antiga foi realmente removida de todas as pastas indicadas.
Verifique se config.txt está corretamente escrito e salvo no diretório do ConnectTEF.
Confira se o nome do processo do PDV está correto.
Informações Importantes
Uso prévio do SiTef:
Esta integração é específica para PDVs que já utilizam SiTef via DLL.
O gerenciador padrão deve estar instalado e configurado antes de aplicar os passos descritos.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Arquivos essenciais:
CliSiTef32I.dll (nova versão).
InterfaceConnectTEF.dll (compatível com a arquitetura – X64, X86, Win32).
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Diretórios críticos:
Remoção de versões antigas:
C:\Windows
C:\Windows\System32
C:\Windows\SysWOW64
Cópia das novas DLLs:
C:\Windows.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Arquivo de configuração:
config.txt dentro do diretório de instalação do ConnectTEF.
Conteúdo obrigatório:
PROCESS_NAME=<nome-do-processo-do-pdv>
Esse arquivo faz o vínculo lógico entre o processo do PDV e o ConnectTEF.
TEF Dedicado (DLL) | Conecte seu sistema a múltiplas adquirentes com facilidade
Resultado da integração:
Após seguir todos os passos:
O PDV passa a estar compatível com o ConnectTEF utilizando a integração via SiTef (TEF dedicado).
Mantém‑se o fluxo tradicional de TEF no PDV, com benefícios de centralização e escalabilidade oferecidos pelo ConnectTEF.
Benefícios de seguir corretamente o procedimento:
Evita conflitos de DLL e erros de TEF.
Aproveita a infraestrutura do ConnectTEF em um ambiente legado SiTef sem reescrever o PDV.
Garante um caminho de migração controlado, mantendo a experiência do operador praticamente inalterada.
Este texto está pronto para ser copiado em um documento Word da sua base de conhecimento. Aplique o padrão visual solicitado: título com fonte 34, cabeçalhos (Resumo, Vídeo, Detalhamento, Informações Importantes) com fonte 18, e o corpo em fonte menor, mantendo os pontos essenciais em negrito para facilitar a leitura por usuários iniciantes.