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.
Em Código de loja, insira o código que foi fornecido pela SkyTef.
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.
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]:
Importante: Para evitar falhas de comunicação ou a necessidade de solicitar um novo token, é essencial manter o padrão estabelecido nos exemplos.
[CliSiTef]
HabilitaTrace=1
DiretorioTrace=C:/CliSiTef
[Geral]
TransacoesAdicionaisHabilitadas=7;8;29;42;
[PinPad]
Tipo Compartilhado
MensagemPadrao=ILLIMITAR|INFORMATICA
  
[SalvaEstado]
DiretorioBase=C:/CliSiTef/chaves
[PinPadCompartilhado]
Porta=AUTO_USB
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
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
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.
Menu SiTef.
Escolha a opção "Teste de comunicação com o Servidor".
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!