Skip to main content

Configuração o SiTef (TLS) no PDV

Este guia explica passo a passo como configurar o módulo de pagamento SiTef no seu Ponto de Venda (PDV), tanto para conexões VPN quanto TLS.

 

1. Localizando a pasta de arquivos (DLLs)

Antes de tudo, precisamos encontrar a pasta lib do PDV. É lá que ficam os arquivos de configuração que vamos ajustar.

  • No Linux: A pasta é /opt/pdv/lib

  • No Windows: A pasta é C:\Program Files\PDV\lib

Nota: Os nossos PDVs mais novos (Navegador PDV 5.3.1) já vêm com os arquivos (DLLs) mais recentes, na versão clisitef-7.0.117.109.r1-Producao (data: 07/17/2025). Você pode confirmar a versão olhando o arquivo RELEASE.txt nessa mesma pasta.

 

 

2. Configuração Inicial (Primeiro Acesso)

Ao abrir o Navegador PDV pela primeira vez, ele pedirá algumas informações de configuração.

    Preencha o Código do Terminal (use a ID referente ou número da conta PDV que está configurado no sistema) e o IP do servidor. Clique na aba SiTef. Marque a opção para Ativar o Modulo SiTef. No campo Servidor, preencha de acordo com o seu tipo de conexão:
      Para VPN: use 127.0.0.1. Para TLS: use https://tls-prod.fiservapp.com.

      37.png

       

       

        Em Código de loja, insira o código que foi fornecido pela SkyTef.

        39.png

         

         

          Em Código terminal, vamos ajustar o código padrão (que geralmente é TT000001). O novo código deve ter 8 dígitos, normalmente começando com "PDV".
            Exemplo 1 (pelo número do PDV): Se o PDV for o 01, use PDV00001. Exemplo 2 (pelo ID da conta): Se o ID da conta PDV for 50, use PDV00050.

            40.png

             

             

            3. Ajustando o arquivo CliSiTef.ini

            Agora, vamos editar um arquivo de configuração. Volte para a pasta lib (que vimos no Passo 1) e abra o arquivo CliSiTef.ini com um editor de textos.

            Precisamos habilitar os traces (registros de log) e definir onde o sistema salvará as chaves de segurança.

            Nota: O arquivo é dividido por seções, como [CliSiTef], [Geral], etc. Se a seção ou a linha não existir, você pode adicioná-la.

             

            3.1. Para Windows

            O arquivo deve ficar parecido com este exemplo. As linhas mais importantes para esta configuração são HabilitaTrace, DiretorioTrace e toda a seção [SalvaEstado]:

            [CliSiTef]
HabilitaTrace $=1$
DiretorioTrace=C:/CliSiTef

[Geral]
TransacoesAdicionais Habilitadas $=7;8;29;42;$

[PinPad]
Tipo Compartilhado [cite: 22]
MensagemPadrao ILLIMITAR | INFORMATICA

[SalvaEstado]
DiretorioBase=C:/CliSiTef/chaves

[PinPadCompartilhado]
Porta-AUTO_USB

            image.png

             

             

            3.2. Para Linux

            No Linux, os caminhos são um pouco diferentes. Você deve adicionar ou ajustar as seguintes linhas:

            *//Na seção [CliSiTef]:

HabilitaTrace =1 
DiretorioTrace=/home/user/CliSiTef 


*//E adicione esta nova seção (ou edite se ela já existir):

[SalvaEstado] 
DiretorioBase=/home/user/chaves

            image.png

             

             

            4. Inserindo o Token no CONFITLS.INI (Apenas TLS)

            Se você está configurando a conexão TLS (aquela que usa o endereço https), temos mais um passo!

              Na mesma pasta lib, encontre e abra o arquivo CONFITLS.INI. Procure a linha que começa com Token Registro=. Você precisará inserir o token (código) fornecido pela SkyTef. O formato deve ser XXXX-XXXX-XXXX-XXXX (com os números no lugar do "X").

                    Exemplo: Token Registro=1234-5678-9012-3456

                    100.png

                     

                     

                    5. Ativação e Teste Final

                    Estamos quase lá! Depois de salvar os arquivos .ini que editamos:

                      Abra o seu PDV, vá até o Menu.

                      image.png

                       

                        Menu SiTef.

                        image.png

                         

                          Escolha a opção "Teste de comunicação com o Servidor".

                          image.png

                           

                            O sistema provavelmente vai pedir para fazer o registro do terminal. Neste momento, você precisa entrar em contato com a SkyTef e solicitar que eles façam a liberação desse novo terminal. Assim que a SkyTef confirmar a liberação, volte ao PDV e faça o teste de comunicação novamente.
                             
                            Se tudo deu certo, você verá a mensagem "Servidor Ativo".
                            Isso significa que o TLS está funcionando perfeitamente!
                            Back to top