TEF PayGo no CES ADM – guia técnico de instalação e uso.

Guia para técnicos da CES Sistemas e das revendas: como preparar o computador, instalar o ponto de captura com o PIN pad, usar o TEF no CES ADM e resolver os erros mais comuns.

Antes de começar

O TEF do CES ADM só funciona com o CES ADM aberto pelo atalho do CES ADM, que roda em 32 bits. Aberto pelo ces.login (64 bits), as telas mostram que o TEF não está disponível.

Parâmetros no CES ADM

Em Cadastros → Empresa → Parâmetros, categoria FINANCEIRO > TEF. Os parâmetros de conexão e de impressão do TEF só são alterados com a senha do técnico.

• A porta do PIN pad não é parâmetro do CES ADM. Ela é informada na instalação da PayGo.
• Configuração da empresa: filiais que usam a mesma configuração compartilham esses valores.
• PDV: busca a configuração de TEF no CES ADM quando é aberto. Depois de mudar um parâmetro, feche e abra o PDV.
• Formas de pagamento: as formas de cartão precisam do campo Tipo TEF preenchido (débito, crédito ou Pix). No CES ADM vale sempre o Tipo TEF; forma sem ele faz o PIN pad perguntar.

Instalação do ponto de captura

A instalação liga o ponto de captura da PayGo a este computador e a este PIN pad. Ela também abre sozinha na primeira venda com cartão, se o computador ainda não tiver instalação.

1. Confirme com a PayGo que o ponto de captura está liberado para instalação.
2. Conecte o PIN pad que vai ficar neste computador.
3. Abra o CES ADM pelo atalho do CES ADM.
4. Vá em Cadastros → TEF → Consulta de transações TEF e clique em Administrativo (exige permissão de gravação nessa tela).
5. Escolha 12 – Instalacao e confirme.
6. Quando aparecer “Aguardando a senha do gerente”, informe a senha de um funcionário gerente.
7. Preencha os dados:

8. Aguarde. A tela do Administrativo fecha sozinha, sem mensagem de sucesso.
9. Para conferir, abra o Administrativo de novo e escolha 11 – Teste comunicacao. Se não aparecer erro, a instalação está válida.
10. Faça uma venda de teste com cartão e cancele em seguida pelo Administrativo.

Regras da instalação

Um ponto de captura vale para um computador e um PIN pad: o que foi usado na instalação. Isso foi confirmado em teste com a PayGo.

• PDV e CES ADM no mesmo computador: não usam a PayGo ao mesmo tempo. Feche um para usar o outro.
• Uma tela por vez: só uma tela do CES ADM usa o TEF de cada vez.
• Nunca encerre o sistema à força com um cartão em andamento. Isso pode corromper a instalação da PayGo no computador (pasta C:\ProgramData\PayGo\PGWebLib) e exigir reinstalação.

Uso no CES ADM

Antes de liberar para o cliente: sem operadora cadastrada para a rede e a bandeira do cartão, a venda do CES ADM recusa o pagamento e desfaz o cartão. Na baixa, o cartão é aceito, mas sem a previsão de recebimento por parcela.

Menu Administrativo da PayGo

Aberto pelo botão Administrativo da Consulta de transações TEF. As opções mais usadas pelo técnico:

O menu também traz relatórios, configuração, manutenção, versão, teste de chaves e dados do terminal. Só use essas opções com orientação da PayGo.

Erros e o que fazer

A maioria dos erros de instalação vem do ponto de captura, não do CES ADM. O texto entre aspas é o que aparece na tela.

Teste de conexão com a PayGo. No PowerShell do computador, troque o endereço e a porta pelos do servidor da PayGo:

Test-NetConnection <servidor> -Port <porta>

TcpTestSucceeded : True = a rede está ok. False = firewall ou internet bloqueando: resolva com a TI do cliente.

Logs e chamado com a PayGo

Os logs da PayGo ficam em C:\ProgramData\PayGo\PGWebLib\Log, um par de arquivos por dia: comms_AAMMDD.log e ppsers_AAMMDD.log (ex.: comms_261109.log = 09/11/2026). A pasta ProgramData é oculta: cole o caminho direto no Explorer.

No comms, cada venda traz a resposta da PayGo: mensagem, código, Unique ID da transação, rede, valor e o modelo e número de série do PIN pad. É o arquivo que a PayGo pede no chamado.

Chamado com a PayGo: portal Sistema de Chamados PayGo, opção Fazer uma pergunta.

Informe no chamado: ponto de captura, CNPJ, servidor, horário e Unique ID das transações recusadas, e o que já foi testado. A resposta chega por e-mail; acompanhe em Solicitações no portal.

Ambiente de teste (homologação)

Só para testes internos, nunca em cliente. O ponto de captura de teste da CES é único: instalado num computador, derruba a instalação do anterior. Combine com o responsável pelo projeto TEF antes de instalar.

1. Copie o arquivo ces.tef.paygo.homologacao para a pasta do sistema que vai passar o cartão (C:\CES Sistemas\ces_adm.Net no CES ADM, C:\CS\CES_PDV no PDV).
2. Libere o ponto de captura de teste no portal da PayGo: aviso Liberação de PdC → aqui, com o CNPJ só em números e o número do ponto de captura. Essa página só libera pontos de captura do ambiente de teste.
3. Instale como na seção “Instalação do ponto de captura”, com os dados de teste.
4. Nos testes, evite R$ 1.000,01 (sai negada) e R$ 1.005,50 (fica pendente): são valores reservados pelo roteiro de homologação da PayGo.
5. Para voltar à produção, apague o arquivo ces.tef.paygo.homologacao e abra o sistema de novo.