Cartões
Procedimentos relacionados a configuração de cartões de crédito e débito no sistema
- Recebimento com Cartão no sistema
- Diferença entre POS x TEF
- POS - Point of Sale (Ponto de Venda)
- TEF - SiTef
- TEF Cloud
- TEF Cloud - Instalação/Configuração
- Pagamento Integrado na NFC-e para o Rio Grande do Sul
- Cadastro das Administradoras
- Cadastro de Produtos/Serviços de Cartão
- Gerar Lote de Recebimento de cartão
- Consulta de Vencimentos de Cartões
- Consultar Transações TEF
Recebimento com Cartão no sistema
Entenda como funciona o recebimento por cartão de crédito em nosso sistema
Diferença entre POS x TEF
Atualmente, aceitar pagamentos por cartões tem se tornado indispensável para os estabelecimentos comerciais, e para que isso seja possível, o estabelecimento precisa optar pela tecnologia que irá utilizar. Os mais comuns são o POS (Point of Sale - ponto de venda) e o TEF (Transferência Eletrônica de Fundos).
O que é o POS?
O POS é a famosa "maquininha de cartão", que o garçom pode levar até a sua mesa, para que você não precise ir até o caixa para pagar a sua conta. Basta inserir o cartão, digitar o valor e a senha, e o comprovante será impresso.
Estas maquininhas, são fornecidas por agências bancárias ou redes adquirentes.
Sua principal vantagem é a mobilidade, pois poderá leva-lá de um lugar a outro, e também utilizá-la nas entregas de delivery, caso possua este serviço.
A desvantagem, é que o POS é mono-adquirente, ou seja, possui apenas uma rede adquirente. Neste caso, talvez seja necessário possuir outros aparelhos POS de outras administradoras, para aceitar as diversas bandeiras de cartão.
Outro ponto é a conferência das vendas do estabelecimento, pois precisará guardar os recibos dos comprovantes e somá-los ao final do dia. Nos casos de volume de vendas muito altos, o processo de conferência pode ser bem trabalhoso, além de que deve se ter muito cuidado ao digitar o valor no momento da venda, para não cobrar um valor incorreto.
O que é o TEF?
O TEF é um software integrado ao sistema de gestão, que fica instalado no computador do caixa. Este software recebe as informações da venda do sistema de gestão, captura os dados do cartão através do PIN PAD, e se comunica com a rede adquirente via internet. Após realizada a transação, o comprovante é impresso por uma impressora térmica.
É muito comum em supermercados, farmácias e varejos com grande volume de vendas, devido a praticidade e agilidade nos recebimentos, evitando filas.
O TEF é multi-adquirente, ou seja, está integrado com diversas administradoras, aceitando diversas bandeiras de cartões, o que é uma vantagem e que torna o processo muito mais rápido e pratico.
Sua principal desvantagem é a mobilidade, pois o PIN PAD fica conectado ao computador, onde será necessário que o cliente vá até o caixa para efetuar o pagamento da sua conta.
Alguns estados não permitem o uso do POS para realizar os recebimentos em cartão, sendo necessário o uso do TEF.
Cada gestor, deverá avaliar os prós e contras de cada tecnologia, e escolher a melhor opção para a sua empresa. Lembrando ainda, que se necessário, é possível utilizar as duas tecnologias em sua empresa.
Enquanto o POS possui maior mobilidade, ainda assim exige do operador o registro das informações da venda no sistema de gestão. Já no TEF, ocorre a comunicação com o sistema de gestão, que já possui todas as informações necessárias facilitando o controle e diminuindo o risco de erros por digitação.
POS - Point of Sale (Ponto de Venda)
TEF - SiTef
Atualmente o Sistema tryideas está integrado com a SiTef.
Neste artigo, iremos detalhar as configurações necessárias no sistema tryideas, bem como o funcionamento na realização de recebimentos em cartão ou carteiras digitais, utilizando o TEF.
1. Contratação do TEF (SkyTEF)
(Incluir os passos necessários - Contratação - Assinatura de Contrato - Instalação do módulo SiTef, etc).
- Solicitar ao cliente interessado um número de Contato;
Enviar os dados do Contato (Nome e Telefone) e o Nome da Empresa para o Diego (programação), que irá repassar o contato para a Claudia, que é do Comercial da Skytef. Ela irá entrar em contato com o cliente para alinhar os detalhes e enviar o contrato. - Preenchimento do Formulário;
Após todos os tramites do contrato serem concluídos, o cliente irá receber um formulário para preencher algumas informações relacionadas a software house, técnico responsável pelo acompanhamento da instalação (que deverá ser alguém da tryideas, e que fará as configurações necessárias), bandeiras utilizadas, dentre outros detalhes dos cartões. - Recebimento de e-mail para agendamento da Instalação do TEF;
Alguns dias depois, o cliente irá receber um e-mail, que possuíra um link para o agendamento do dia e horário da instalação e configuração do TEF. É importante o cliente confirmar com o atendente da tryideas que está como responsável pelo acompanhamento, a disponibilidade de dia e horário a serem agendados. - Instalação, configuração e testes do SiTef;
No dia da instalação, a Skytef irá realizar a configuração do SiTef em uma máquina virtual, e irá repassar os dados para serem configurados no sistema tryideas, como IP de comunicação entre outros. Os passos para a configuração estão descritos logo abaixo, basta seguir os processos e ao final realizar os testes necessários.
2. Configurações tryideas
Antes de tudo, precisamos realizar algumas configurações para possibilitar o uso dos recebimentos em cartão, via TEF.
Após isso, iremos configurar uma sessão para o Operador de Caixa. Podemos considerar como uma numeração de PDV, ou seja, considere como os Caixas de um Supermercado, onde cada Operador possui o seu Caixa, e estes possuem uma numeração distinta. Desta forma, caso a empresa possua mais de um Caixa, para cada Operador será necessário realizar esta configuração, utilizando números de terminais diferentes.
Neste passo iremos acessar o menu: Configurações > Configurar Sessão.
-> Descrição - Insira uma descrição para a Sessão, como por exemplo "TEF";
-> Operador - Selecione o Operador de Caixa, para o qual está sendo realizado a configuração da Sessão;
-> Impressora Térmica - Na coluna "Impressora Térmica", defina a impressora que fará a impressão dos comprovantes das transações do TEF;
-> Térm. Auto? - Selecione esta opção para habilitar a impressão automática
-> Nº Terminal SiTef - Localize a coluna "Nº Terminal SiTef", e informe o número do terminal do caixa (Ex: SW000001, SW000002....).
Cadastro da Administradora
Administradora - Informe uma descrição para identificar a credenciadora SiTef;
Conta Depósito* - Selecione uma Conta Bancária a qual irá receber pelas movimentações em cartão ou carteiras digitais;
Despesa Taxas* - Selecione uma Despesa para o lançamento das taxas;
Receita* - Selecione uma Receita, para o lançamento dos valores recebidos em cartão ou carteiras digitais;
CNPJ Credenciadora - Informe o CNPJ que será destacado nos Dados de Pagamento da NFCe.
* Os campos destacados, serão considerados na geração de Lote dos Recebimentos em Cartão, após o vencimento que será configurado logo abaixo para os Produtos/Serviços.
Cadastro de Produtos/Serviços
Descrição - Informe uma descrição para identificar o Produto/Serviço;
Filial - Selecione a Filial relacionada ao cadastro;
Administradora - Selecione a Administradora cadastrada no passo acima;
Limite de Parcelas - Informe o Limite de Parcelas caso necessário. A quantidade de Parcelas deverá será definida durante a transação, caso selecionado a opção "parcelamento". Não existe opção do sistema enviar esta informação conforme o parcelamento definido na tela de recebimento.
Tipo de Cartão - Esta opção permite agilizar o processo de recebimento, evitando precisar selecionar se é Crédito, Débito, Carteira Digital, etc durante a comunicação com o SiTef. Basicamente uma tela a menos será necessária caso configure o Tipo de Cartão previamente, sendo possível já deixar configurado um registro de cada opção (Crédito, Débito e PIX).
Para o Controle de Geração de Lotes dos recebimentos em Cartão no sistema tryideas, onde os valores são creditados na Conta bancária configurada no dia do vencimento da parcela, existem duas opções:
1) Definir o número de Parcelas na tela de recebimento, e também durante a transação com o TEF.
2) Desabilitar a geração de lotes automática, e realizar o controle dos recebimentos e das taxas manualmente;
Recomendamos criar um numerário rápido para os Produtos/Serviços do TEF, afim de agilizar nos recebimentos.
3. Guia de uso
Iremos apresentar abaixo o fluxo de um recebimento em cartão ou carteiras digitais pelo TEF, após realizar a venda de Produtos, Serviços, ou algum outro recebimento avulso.
A tela de recebimentos, conforme a imagem abaixo será exibida, onde possuímos o valor a ser recebido, e também podemos visualizar os numerários criados a partir do cadastro de Produtos/Serviços realizados no passo acima.
Vamos simular diferentes situações que ocorrem no dia-a-dia, para entendermos como iremos proceder nos diferentes processos de recebimento, em situações de utilizar um cartão ou vários para o recebimento de uma conta.
1. Recebimento do Valor integral em apenas UM Cartão ou no PIX
Nesta situação, podemos clicar sobre o numerário (ou utilizar o atalho, ex: (Control + 5) ou o número desejado), onde o valor total será atribuído ao numerário e clicamos em Gravar (F5) para confirmar o recebimento.
2. Recebimento parcial em Cartão e restante em Dinheiro
Neste caso iremos informar o Valor que iremos receber no Cartão diretamente na coluna "Valor" do numerário desejado (Crédito ou Débito), e o valor restante será recalculado para o numerário Dinheiro.
3. Recebimento parcial no Cartão de Crédito, parcial no Débito e restante em Dinheiro
Semelhante a situação acima, iremos definir o Valor recebido no Crédito, o Valor em Débito e o restante ficará aplicado para o numerário Dinheiro.
4. Recebimento em DOIS Cartões de Crédito e o restante no Cartão de Débito
Neste caso, iremos utilizar o numerário CARTÃO que nos permite selecionar o Produto/Serviço desejado e informar o Valor. Esta opção permite a inclusão de vários Cartões do mesmo tipo, ou seja, podemos incluir mais de um recebimento com o mesmo Produto/Serviço. Após a inclusão dos valores dos dois cartões de Crédito, atribuímos o valor restante ao numerário rápido "Débito".
É possível também realizar o cadastro de mais de um Produto/Serviço "Crédito", como por exemplo, "Crédito 1", "Crédito 2" e "Crédito 3", caso tenha situações de recebimentos em até TRÊS Cartões de crédito diferentes.
Esta opção agilizaria o recebimento, visto que podemos inserir o valor desejado diretamente no numerário rápido. É uma opção a ser analisada para cada tipo de uso.
Agora que vimos algumas situações que podem ocorrer no dia-a-dia, vamos para o fluxo de comunicação com o SiTef.
Comunicação com o SiTef
Após definirmos o valor dos numerários que o cliente irá utilizar para pagar, iremos clicar em "Gravar", na tela de Recebimento, e se algum Numerário utilizado esteja configurado para utilizar o TEF, uma nova tela será exibida.
Esta tela requer a interação e atenção do Operador de Caixa para o correto registro e confirmação das transações.
Vamos aos exemplos de uso das opções, conforme ilustrações abaixo.
Recebimento à Vista no Cartão de Crédito
- Na tela de seleção de Formas de Pagamento, selecione a opção "A Vista".
Recebimento Parcelado no Cartão de Crédito
- Na tela de seleção da Forma de Pagamento, selecione a opção "Parcelado" e a seguir informe o número de Parcelas.
Recebimento em DOIS Cartões (Crédito e Débito)
- Nesta situação, as transações são realizadas uma logo após a outra. O Cliente deverá observar no PINPAD o Valor que está sendo exibido, para identificar qual Cartão deverá inserir ou aproximar no pinpad para a transação.
Cancelamento da Transação em andamento
- Caso deseje cancelar uma transação em andamento, basta utilizar a tecla ESC do teclado, ou clicar em Cancelar Solicitação no botão do rodapé da tela, quando este estiver sendo exibido.
Cancelamento de Transação já confirmada (Transação Gerencial)
- Caso necessite cancelar uma transação já finalizada, ou seja, após a impressão dos comprovantes e finalização do recebimento, é possível realizar uma Transação Gerencial.
Para isso acesse o menu: Caixa > Consultar Transações TEF.
Para este processo, o cliente deverá estar presente de posse do Cartão utilizado na transação, e possuir o comprovante do pagamento. (É possível também visualizar os dados da transação necessários na tela de consulta que acabamos de abrir).
Na ilustração abaixo, observe que pesquisamos a transação que desejamos cancelar, para facilitar na visualização dos dados.
- Ao clicar na Transação Gerencial será iniciado a comunicação com o SiTef, sendo exibida uma tela com as opções disponíveis.
- Selecione a opção de Cancelamento de Transação;
- Após isso informe a Senha do Supervisor (obtenha esta senha com o suporte da tryideas, caso não a possua);
- Selecione o tipo de cancelamento conforme a transação original, Cancelamento de cartão de Débito ou Crédito;
- Informe o Valor da Transação que deseja cancelar;
- Informe a Data da Transação;
- Após isso será solicitado para inserir o número do documento a ser cancelado. Informe o NSU Host neste passo, que pode ser visualizado na tela de consulta de transações, ou no comprovante impresso.
- E por fim, será solicitado para inserir o Cartão no pinpad, para confirmar o cancelamento da transação.
Se todas informações inseridas estiverem corretas, e nenhuma divergência ocorrer, ou alguma mensagem de erro aparecer, a transação estará cancelada.
Recebimento em PIX
O processo para recebimento em PIX é simples, após iniciar a comunicação com o SiTef, o QRCode será exibido no pinpad caso este possua suporte, ou então será exibido na tela, para que o cliente faça a leitura pelo seu aplicativo do banco instalado em seu celular. Após a confirmação da transação, a tela será fechada e o recebimento finalizado.
Dúvidas gerais
1) Em um recebimento em 2 cartões, o cliente passou o primeiro cartão, informou a senha tudo ok, e no segundo cartão ocorreu um erro, ou não possuía limite suficiente no cartão, como fica a transação?
R: Caso alguma transação não seja finalizada corretamente, todas as anteriores são canceladas automaticamente.
2) No meio da Transação de um recebimento em cartão, houve uma queda de energia, a transação será cancelada?
R. Sim. Caso ocorra uma queda de energia, uma reinicialização da aplicação ou do computador, etc, assim que a próxima transação for iniciada, as transações pendentes serão canceladas automaticamente.
3) Quais as instituições integrados com a SiTef para o recebimento em PIX?
R. Certificações concluídas até 08/11/2022:
-
Ailos
-
Banco Senff AS
-
Banco do Brasil
-
Banco Original
-
Bradesco
-
Cielo
-
Gerencianet
-
Itaú
-
Mercado Pago
-
PagSeguro PagBank
-
Quero Quero Pag (VerdeCard)
-
Realize CFI
-
Santander
-
Sicoob
-
Sicredi
-
Tribanco
4) O que fazer em caso de erros ou problemas durante a transação TEF, como por exemplo 31 - Erro PINPAD ?
R. O ideal é solicitar suporte através do Assistência Segura, onde o técnico irá analisar o problema ocorrido, e dependendo da situação, deverá ser solicitado o suporte da SkyTef, pelo telefone 0800 9797 625 ou (11) 2175-9501, ou pelo chat no seguinte link.
Para o Erro 31, tente executar os seguintes passos. Abra o Gerenciador de Dispositivos, e nos Controladores USB e Portas (COM e LPT), verifique se existem portas do PINPAD (PPC930 por exemplo, no caso da Gertec) com a descrição esmaecida, como se estivessem desabilitados. Caso possua, faça uma limpeza removendo essas portas.
Para o erro 31, pode acontecer de o pinpad não estar instalado corretamente no computador, nesta caso, entrei em contato com o suporte da Skytef, que fizeram a instalação do drive do pinpad, depois da instalação, desconectamos e conectamos ele novamente no computador, e funcionou corretamente.
Após isso reabra o sistema e faça um novo teste de transação em Cartão, para verificar se o PINPAD responde.
Outra dica é desconectar o PINPAD e reconectar, pois em alguns casos pode ficar travado, desta forma será reiniciado.
5) Quando aparecer a mensagem Sem conexao Servidor, o que fazer?
R. Esta mensagem será exibida quando não for possível uma comunicação do computador local, com o servidor do Sitef, seja por algum bloqueio, ou por outros motivos.
Opção 1: reiniciar o serviço da VPN, para isso abra o services.msc e localize o serviço WNB Monitor, e reinicie o serviço. Após isso, tente realizar a transação novamente.
6) Quando aparecer a mensagem Retorno não catalogado - [Código 99], o que fazer?
R. Geralmente, o problema ocorre após a Skytef atualizar a dll do sistema.
Ocorre que eles verificam o nome do arquivo CliSiTef32l.dll e transferem a dll 32 bits, porém utilizamos a versão x64, onde apenas renomeamos a dll. Para corrigir o problema, é necessário solicitar a dll 64 bits, e renomear o arquivo para 32, e reabrir o sistema para carregar a dll correta.
Contato do suporte da Skytef
Telefones: 0800 9797 625 ou (11) 2175-9501
E-mail: suporte.tef@skytef.com.br
Se nenhuma das opções acima resolver o problema, entre em contato com o suporte da SkyTef, onde eles irão realizar uma conexão remota via TeamViewer (o executável geralmente está na area de trabalho, é o mesmo utilizado na instalação. Segue link para instalação).
TEF Cloud
1. O que é o TEF Cloud?
O TEF Cloud é a solução do TryERP para realizar pagamentos eletrônicos diretamente pelo sistema, principalmente no uso de VM (sistema em nuvem). Atualmente integra com o provedor ControlPay/PayGo, permitindo realizar cobranças em cartão de crédito, débito, voucher, PIX e carteira digital diretamente pelo sistema, sem necessidade de software TEF dedicado instalado na máquina. A comunicação é feita via API REST com o servidor do ControlPay, que por sua vez se comunica com o aplicativo PayGo Windows instalado no computador do caixa (que controla o PIN Pad).
Com ele, você pode receber pagamentos por:
-
Cartão de crédito
-
Cartão de débito
-
PIX
-
Vale alimentação/refeição (voucher)
-
Carteiras digitais
Tudo isso integrado ao seu caixa, utilizando o PIN Pad, sem necessidade de sistemas adicionais complexos.
2. Como funciona?
De forma simples:
-
O operador inicia a cobrança no sistema
-
O TryERP envia a solicitação para o sistema de pagamento
-
O PIN Pad é ativado automaticamente
-
O cliente realiza o pagamento (cartão ou PIX)
-
O sistema recebe o retorno
-
A venda é finalizada automaticamente
✔️ Tudo acontece em poucos segundos
✔️ Sem digitação manual de valores no PIN Pad
3. O que é necessário para usar?
Antes de utilizar o TEF Cloud, é necessário:
-
Ter uma conta ativa no sistema de pagamentos (ControlPay / PayGo)
-
Ter o PayGo Windows instalado no computador do caixa
-
Ter um PIN Pad conectado
-
Estar com acesso à internet
4. Configuração do TEF Cloud
A configuração é feita no sistema:
Caminho:
👉 Configurações Adicionais → Aba TEF Cloud
4.1 O que precisa ser preenchido?
Os principais campos são:
-
Filial: selecione a empresa que será configurada
-
URL da API: normalmente já vem preenchido automaticamente
-
Senha ControlPay: senha do seu acesso ao sistema de pagamentos (opcional, apenas para obter a chave de integração)
-
Chave de Integração: obtida automaticamente pelo botão
-
Terminal Padrão: identificação do seu PIN Pad
-
Produção: marque quando for utilizar em ambiente real
-
Ativo: habilita o uso do TEF Cloud
4.2 Botões disponíveis
-
Login / Obter Chave
→ Busca automaticamente a chave de integração -
Testar Conexão
→ Verifica se está tudo funcionando corretamente -
Salvar
→ Grava as configurações
5. Configuração por Operador (Terminal TEF Cloud)
Além da configuração da filial, é obrigatório configurar o terminal por operador (caixa/PDV).
Onde configurar
Caminho:
👉 Configurações → Configurar Sessão
Campo obrigatório
-
Terminal TEF Cloud
Código identificador do terminal de pagamento vinculado ao operador.
Como funciona
-
Cada operador (caixa) deve possuir um terminal próprio
-
Esse código define qual PIN Pad será utilizado
-
A configuração é individual por estação
Exemplo
-
Caixa 1 → Terminal 5453
-
Caixa 2 → Terminal 5454
-
Caixa 3 → Terminal 5455
Importante
-
Configuração obrigatória para funcionamento
-
Sem esse campo preenchido, pagamentos não serão iniciados
-
Não compartilhar o mesmo terminal entre caixas simultaneamente
6. Como realizar um pagamento
Durante uma venda:
-
Escolha a forma de pagamento (cartão, PIX, etc.)
-
O sistema abrirá a tela de processamento
-
O PIN Pad será ativado
-
O cliente realiza o pagamento
-
Aguarde a confirmação
7. Status do pagamento
Durante o processo, você poderá visualizar o status:
-
Aguardando → iniciando operação
-
Em processamento → cliente está pagando
-
Aprovado → pagamento concluído com sucesso
-
Negado → pagamento recusado
-
Cancelado → operação cancelada
-
Erro → falha na comunicação
8. Cancelar um pagamento
O cancelamento (estorno) de uma transação TEF Cloud pode ser realizado de duas formas:
1. Pela tela de Transações TEF
-
Acesse a tela de consulta de transações (Caixa > Consultar Transações TEF)
-
Selecione a venda desejada
-
Clique em Cancelar TEF Cloud
-
Confirme a operação
2. Pelo cancelamento da venda (NFe/NFCe ou Movimento)
Quando a transação estiver vinculada a uma venda, o processo pode ser ainda mais simples:
-
Acesse a consulta de NFe/NFCe ou o Movimento
-
Solicite o cancelamento da venda
-
O sistema exibirá uma mensagem de confirmação
-
Ao confirmar, o estorno TEF será realizado automaticamente
⚠️ Importante
-
Não é necessário realizar o cancelamento em duas telas
-
O estorno é feito automaticamente junto com o cancelamento da venda
-
O processo garante mais agilidade e evita erros operacionais
⚠️ Importante:
O cancelamento irá solicitar o Cartão utilizado na transação e a confirmação no PIN Pad.
9. Consulta de transações
Na tela de consulta, você pode:
-
Visualizar todas as vendas realizadas
-
Filtrar por período
-
Conferir status
-
Ver dados como:
-
Valor
-
Autorização
-
NSU
-
Forma de pagamento
-
10. Reimpressão de comprovante
Caso necessário:
-
Selecione a transação
-
Clique em Reimprimir Via
11. Dicas importantes
✔️ Sempre teste a conexão após configurar
✔️ Verifique se o PIN Pad está conectado corretamente
✔️ Não feche a tela durante uma transação em andamento
12. Possíveis problemas e soluções
PIN Pad não abre
-
Verifique se o PayGo está instalado e rodando
Erro de conexão
-
Verifique a internet
-
Teste a conexão nas configurações
Transação não finaliza
-
Aguarde alguns segundos (tempo de processamento)
-
Caso necessário, consulte a transação depois
13. Suporte
Em caso de dúvidas ou problemas:
-
Entre em contato com o suporte do sistema
-
Tenha em mãos:
-
Data da transação
-
Valor
-
Número da autorização (se houver)
-
✅ Conclusão
O TEF Cloud traz mais praticidade, segurança e agilidade para o seu caixa, integrando os pagamentos diretamente ao sistema e evitando erros manuais.
TEF Cloud - Instalação/Configuração
1. Visão Geral
O TEF Cloud no TryERP utiliza o ControlPay (PayGo) como intermediador de pagamentos, com comunicação via API REST e execução local através do PayGo Windows.
Essa documentação tem como objetivo orientar o time de suporte na configuração correta e resolução de problemas.
2. Instalação do PayGo Windows
Para o funcionamento do TEF Cloud, é obrigatório instalar o PayGo Windows em cada estação (caixa/PDV) que receberá pagamentos.
📥 Download
👉 https://paygodev.readme.io/docs/kit-de-integração-1
-
Acessar a página do link acima
-
Localizar Kit de Integração
-
Clicar em “Clique aqui” para baixar
💻 Instalação
-
Executar o instalador baixado
-
Informar o CPF ou CNPJ da empresa
-
Inserir o ID de instalação recebido
- Inserir a Senha recebida
- Clicar em Ativar
- Quando solicitar a Porta USB do PIN PAD, digite 0 (zero) e tecle ENTER
▶️ Execução
-
O PayGo será executado e ficará disponível ao lado do relógio do Windows (bandeja do sistema)
⚙️ Configuração inicial
Após a instalação:
-
Abrir o PayGo (ícone na bandeja)
-
Acessar Configurações
-
Validar:
-
Comunicação com PIN Pad
-
Configuração de impressão (se aplicável)
-
⚠️ Importante
-
O PayGo deve estar em execução para que o TEF funcione
-
Deve ser instalado em todas as máquinas de caixa
-
O PIN Pad deve estar corretamente conectado e reconhecido
-
Sem o PayGo, nenhuma transação será iniciada
🧪 Teste recomendado
Após instalar:
-
Acessar a opção Testar conexão com PIN Pad dentro do PayGo
-
Garantir que o dispositivo responde corretamente
3. Configuração no Painel ControlPay
O ControlPay possui configurações essenciais que impactam diretamente o funcionamento do ERP.
3.1 Geração da Chave de Integração
⚠️ IMPORTANTE
O botão “Login / Obter Chave” do ERP NÃO deve ser utilizado, pois gera uma chave com validade (expira).
✅ Procedimento correto:
-
Acessar o painel ControlPay
-
Ir em:
Integrações / Config → Aba Chaves de Integração -
Clicar em Nova chave
-
Preencher:
-
Nome:
tryerp(ou outro identificador) -
Não informar data de expiração
-
-
Salvar
-
Copiar a chave gerada para o ERP
3.2 Configuração de Terminais
Regras:
-
Cada PDV = 1 terminal
-
Código será usado no ERP
-
Não compartilhar entre caixas
4. Configuração do TEF Cloud no ERP (Por Filial)
📍 Configurações → Configurações Adicionais → Aba TEF Cloud
Campos
Filial
-
Configuração independente por empresa
Provedor
-
ControlPay
URL da API
| Ambiente | URL |
|---|---|
| Sandbox | https://sandbox.controlpay.com.br/webapi |
| Produção | https://api.controlpay.com.br |
Senha ControlPay
-
❌ Não utilizar
Chave de Integração
-
Deve ser gerada no ControlPay
-
❗ Sem expiração
Terminal Padrão
-
Terminal fallback (informar o número do terminal padrão a ser utilizado, caso não seja definido na sessão, ou logado com sessão incorreta).
Atenção a essa configuração, o terminal do Operador precisa ser utilizado no mesmo Caixa para onde foi configurado, pois existe um "vínculo" da instalação do ControlPay na máquina com o terminal configurado para o Operador. Em resumo, imagine o sistema executando na nuvem, ao iniciar a transação envia um comando para a api do PayGo onde é enviado o terminal, e a api vai se localizar e se comunicar com o app instalado na máquina. Se possuir 2 caixas e inverter os Operadores, o PayGo será exibido no PDV incorreto.
Senha Técnica
-
Usada para cancelamento
-
Deve coincidir com ControlPay
Timeout
-
Padrão: 120s
Polling
-
Padrão: 3s
Produção
-
Marca ambiente real
Ativo
-
Habilita TEF
Botões
-
❌ Login / Obter Chave → não usar
-
✔️ Testar Conexão → validar integração
-
✔️ Salvar
⚠️ Erros comuns
-
Chave expirada
-
URL incorreta
-
Integração inativa
5. Configuração por Operador (Sessão)
📍 Configurações → Configurar Sessão
Campo obrigatório
-
Terminal TEF Cloud
Regras
-
Cada operador = 1 terminal
-
Deve existir no ControlPay
-
Define o PIN Pad utilizado
6. Senha Técnica (Cancelamento)
A senha técnica é utilizada para realizar estornos.
📍 Onde obter:
ControlPay → Integrações / Config → Aba Opções da Venda
📌 Configuração:
-
Copiar a senha técnica
-
Informar no ERP em:
-
Configuração TEF Cloud (por filial)
-
⚠️ Regra importante:
-
O cancelamento só pode ser feito pelo mesmo terminal que realizou a venda
7. Cancelamento de Transações
Regras:
-
Cancelamento depende da senha técnica correta
-
Deve ser feito pelo mesmo terminal
-
Pode ser feito:
-
Pela tela de transações TEF
-
Pelo cancelamento da venda (NFe/NFCe/Movimento)
-
8. Configuração do PayGo Windows (Impressão)
O PayGo pode ser responsável pela impressão dos comprovantes.
📍 Caminho:
-
Abrir o PayGo (ícone ao lado do relógio)
-
Acessar Configurações
⚙️ Configurar:
-
Habilitar:
-
Serviço de impressão automático
-
-
Tipo:
-
Windows
-
-
Selecionar impressora desejada
⚠️ Integração com ERP:
Se a impressão for feita pelo PayGo:
👉 No ERP (Configurar Sessão):
-
Marcar opção: Não imprimir TEF Cloud
🔁 Regra:
| Situação | Configuração |
|---|---|
| Impressão via PayGo | ERP NÃO imprime |
| Impressão via ERP | PayGo NÃO imprime |
9. Cadastro de Administradoras
Foram adicionados novos campos para otimizar o fluxo de pagamento.
Novos campos:
-
Adquirente Cartão
-
Adquirente PIX
Funcionamento:
-
Se preenchido:
-
O PayGo não solicita seleção
-
Fluxo direto para pagamento
-
-
Se não preenchido:
-
Operador precisa escolher a adquirente
-
📌 Quando usar:
-
Cliente possui múltiplas adquirentes
-
Deseja automatizar o fluxo
10. Cadastro de Produtos / Serviços
Para melhorar a automação no pagamento:
Configuração obrigatória:
-
Definir o Tipo de Cartão:
-
Crédito
-
Débito
-
PIX
-
Benefício:
-
PayGo já recebe a informação
-
Não exibe opções para o operador
-
Processo mais rápido e sem erros
11. Logs do Sistema
Os logs são essenciais para análise de problemas.
📁 Local:
📄 Nome do arquivo:
📌 Exemplo:
📊 Conteúdo:
-
Envio de transações
-
Retornos da API
-
Status de processamento
-
Erros
🕒 Retenção:
-
Mantidos por 7 dias
-
Após isso, são removidos automaticamente
12. Log Detalhado (Debug)
Para análise avançada:
📍 Caminho:
👉 Configurações → Configurações Globais
→ Financeiro → Configurações do Caixa
Opção:
-
Habilitar log detalhado do TEF Cloud
🔍 O que muda:
-
Salva JSON completo:
-
Requisição
-
Resposta da API
-
⚠️ Uso recomendado:
-
Apenas para suporte / diagnóstico
-
Pode gerar arquivos maiores
13. Boas Práticas de Suporte
-
Sempre validar:
-
Chave de integração (sem expiração)
-
Terminal configurado corretamente
-
Senha técnica válida
-
-
Conferir se o PayGo está aberto
-
Validar conexão com internet
-
Verificar logs antes de acionar terceiros
- Desativar economia de energia USB
No gerenciador de dispositivos, em cada USB Root Hub, abra as propriedades e na aba Gerenciamento de Energia, desmaque a opção "O computador pode desligar...", após isso clique em OK para salvar.
14. Problemas Comuns
❌ Transação não inicia
-
Terminal não configurado
-
Chave inválida
-
PayGo não aberto
❌ Erro ao cancelar
-
Senha técnica incorreta
-
Tentativa em terminal diferente
❌ PIN Pad não responde
-
PayGo não está rodando
-
Problema de driver/conexão
❌ Impressão duplicada
-
PayGo e ERP imprimindo juntos
15. Checklist Rápido (Suporte)
Antes de escalar:
-
✔️ PayGo aberto
-
✔️ PIN Pad funcionando
-
✔️ Terminal configurado
-
✔️ Chave válida
-
✔️ Senha técnica correta
-
✔️ URL correta
-
✔️ Integração ativa
16. Considerações Finais
A maioria dos problemas está relacionada a:
-
Configuração incorreta de terminal
-
Uso de chave expirada
-
Falha na instalação/configuração do PayGo
17. Dados para Integração com PayGo (ACBr)
Para ativação do TEF Cloud junto ao PayGo, é necessário realizar um cadastro junto ao integrador (ACBr), que fará a validação dos dados com a adquirente.
📌 Dados obrigatórios
Devem ser informados os seguintes dados:
- Estabelecimento
- Lógico TEF (nem sempre irá existir essa informação)
Esses dados são utilizados para:
- Identificar o cliente junto à adquirente
- Validar o credenciamento
- Liberar o uso do TEF Cloud no ambiente
🔄 Processo
- O cliente fornece os dados ao suporte
- O suporte envia para o ACBr
- O ACBr realiza validação com a adquirente
- Após validação, o ambiente é liberado para uso
🔍 Onde obter esses dados
🔹 1. Comprovante de venda (POS)
Se o cliente já possui uma maquininha (POS), os dados podem ser encontrados no comprovante impresso.
Exemplo:
- ESTAB / EC → número do estabelecimento
- Lógico TEF → número do terminal lógico
📌 Normalmente aparecem como:
ESTAB=XXXXXXXXXXXX-
TERM=XXXXXXXXou similar
🔹 2. E-mail da adquirente
Caso o cliente não possua POS:
- Os dados são enviados por e-mail pela adquirente no momento do credenciamento
📌 O cliente deve:
- Localizar o e-mail de credenciamento
- Ou solicitar novamente junto à adquirente
💡 Orientação para suporte
Ao solicitar os dados ao cliente:
- Pedir foto de um comprovante recente (se tiver POS)
ou - Solicitar o e-mail de credenciamento da adquirente
Isso evita erro de digitação e acelera a liberação.
Pagamento Integrado na NFC-e para o Rio Grande do Sul
Calendário de Obrigatoriedade
Ebook da AFRAC sobre Pagamento Integrado
Site da SEFAZ RS com as dúvidas gerais
Cadastro das Administradoras
Para cadastrar uma administradora de cartões (a maquininha) no sistema tryideas siga os seguintes passos:
Obs: Verifique se já possui uma conta de banco cadastrada no sistema antes de cadastrar a administradora. Para cadastrar clique aqui.
2 - Procure pelo submenu Cartão de Crédito e selecione a opção Cadastrar Administradoras;
3 - No primeiro campo informe o nome da Administradora ou uma descrição para a mesma;
4 - Em Conta Depósito selecione sua conta bancária previamente cadastrada;
5 - No campo Despesa Taxa informe uma despesa para registro das taxas, normalmente utilizado Juros Pagos;
6 - No campo da Receita preencha a receita para registo dos valores recebidos, o padrão é Recebimentos.
7 - O CNPJ Credenciadora é opcional, sendo obrigatório informar em alguns estados para constar na forma de pagamento da NFe e NFCe.
8 - O checkbox Utiliza TEF e Índice de Rede estão melhor explicados neste manual, caso tenha interesse na modalidade sem utilização da maquininha confira o mesmo.
O cadastro seguindo o manual fica desta forma:
Para configurar os produtos (débito, crédito à vista) e as taxas de juros da administradora siga este manual: Cadastro dos Produtos/Serviços.
Cadastro de Produtos/Serviços de Cartão
Após configurar sua administradora de cartões, é necessário também configurar suas taxas de juros. Vamos ao passo a passo:
2 - Normalmente as administradoras tem um taxa para vendas em débito, uma taxa de crédito de 3 ou 6 vezes e outra para vendas com mais parcelas, até 12. Antes de cadastra-las consulte sua administradora para verificar quais são elas e as condições;
3 - Com as taxas em mãos, abra a tela de cadastro e na Descrição preencha com uma informação que ficará fácil de localizar depois. Se você tem mais de uma administradora coloque uma identificação também, exemplo: ELO DÉBITO, GETNET CRÉDITO ATÉ 3X, REDE CRÉDITO À VISTA;
4 - Selecione a Filial e a Administradora que serão relacionadas a este cadastros;
5 - Nos campos numéricos é necessário um pouco mais de atenção, vamos à eles:
- Dias Prazo: prazo de dias que o valor da venda irá levar para cair na sua conta, débito preencha com 1 e crédito com 30.
- Limite de Parcelas: quantas parcelas será o máximo para a venda. Débito sempre 1 e crédito de acordo com a sua necessidade. Se este cadastro é de uma taxa até 3 vezes por exemplo, o valor neste campo deve ser 3.
- % Taxa: porcentagem de juros para este produto.
- Valor Tarifa: caso além de juros a administradora cobre tarifa, informa neste campo.
- % Taxa na Antecipação: caso sua administradora ofereça o serviço de antecipação dos valores das suas vendas e cobrem juros sobre isso, preencha aqui o valor do juros.
- Tipo de Cartão: opcional e utilizada para o TEF, caso queira saber mais clique aqui.
- Bandeira: também é opcionais mas pode ser obrigatório em alguns estados, irá aparecer nas informações de pagamento da NFe e NFCe.
Exemplos de cadastros (valores ilustrativos)
Débito:
Crédito à vista:
Crédito com limite de parcela de 6 vezes:
Consulta de Produtos/Serviços
Para adicionar essas condições de pagamento na tela de faturamento, para facilitar as vendas que não foram parceladas basta Consultar os Produtos/Serviços, selecionar 1 por vez e clicar na opção Incluir/Excluir Numerário na parte superior da tela:
Faça isso somente com os serviços que são em 1 vez!! Débito e crédito à vista!
Desta forma quando você for liquidar alguma fatura a tela de liquidação ficará assim:
Nas suas vendas parceladas clique sobre Cartão, selecione a Administradora, o Produto e no campo Parcelas informa em quantas vezes foi a venda.
Gerar Lote de Recebimento de cartão
A tela de Geração de Lote permite ao usuário consolidar manualmente lançamentos de vendas feitas com cartão de crédito/débito em um lote, informando receitas e despesas associadas, para facilitar a conciliação financeira.
Obs.: Caso seu sistema esteja configurado para fazer a geração de lotes automaticamente, o sistema exibirá uma mensagem de que a Geração de Lotes esta configurada para ser realizada automaticamente e não permitirá abrir essa tela. Caso queira fazer esse procedimento manualmente será necessário desabilitar essa configuração.
Para fazer a geração do lote, irá acessar o menu Cadastros, depois irá na opção Financeiro e ainda na opção Gerenciar Cadastros, no campo de pesquisa, poderá pesquisar por Gerar Lotes, e o sistema irá exibir as opções Gerar Lote de Recebimentos.
Clicando na operação de Gerar Lote de Recebimento, o sistema irá exibir a tela com os campos que deverá preencher poder
pesquisar os valores que ainda tem a receber, os campos são eles:
Produto: Refere-se ao nome do produto ou serviço vinculado à venda no cartão
Período: Define o intervalo de tempo para buscar os lançamentos (Ex: Últimos 30 dias, Este mês, etc).
Após preencher os campos pode clicar em pesquisar e o sistema irá exibir os lançamentos com as seguintes colunas:
Parcela: Número da parcela da venda.
Data Vencimento: Data prevista para recebimento
Valor Bruto: Valor da venda antes das taxas.
Valor Tarifa/Taxa: Valores cobrados pela administradora (tarifas e taxas).
Valor Líquido: Valor final a ser recebido.
Administradora: Nome da operadora de cartão (ex: Cielo, Rede, etc).
Após consultar as valores que tem a receber, poderá marcar cada uma que deseja fazer a geração do lote, e clicar no botão Gerar Lote (F5), o sistema irá fazer a geração e consolidação do valor na sua conta bancaria.
Consulta de Vencimentos de Cartões
Esta tela tem como finalidade consultar os valores a receber de vendas feitas por meio de cartões, exibindo detalhes como parcelas, taxas, valor líquido, se já foi lançado no financeiro e o número do lote.
Para fazer a consulta, você irá acessar a tela pelo menu Cadastros, depois irá na opção Financeiro e ainda na opção Gerenciar Cadastros, no campo de pesquisa, poderá pesquisar por Vencimentos, e o sistema irá exibir a opção Consultar Vencimentos.
Clicando na opção de consultar vencimentos o sistema irá exibir a tela com os campos que deverá preencher para fazer a consulta.
Filial: Irá selecionar a filial no sistema a qual deseja fazer a consulta
Produto: Refere-se ao nome do produto ou serviço vendido via cartão. Pressione Enter para escolher. (Ex: Crédito ou Débito).
Período: Filtra os vencimentos por período: "Este Mês", "Mês Anterior", "Personalizado", etc.
Filtro: Define o tipo de lançamento a visualizar: Todos, Lançados (já registrados no financeiro) ou Não Lançados (pendentes de lançamento).
Após preencher os campos pode clicar em Pesquisar (F3), para exibir os registros
Na parte de baixo da tela tem as opções de Imprimir
que gera uma versão para impressão do relatório exibidos na tela, e ainda Lançar Adiantamento que permite adiantar o valor de algum desses lançamentos.
Consultar Transações TEF
Neste manual estaremos apresentando como fazer a Consulta de Transações TEF no seu sistema. Essas transações são feitas através da sua máquina de cartão de crédito, no qual esta configurada junto ao sistema para efetuar as liquidações.
Para fazer a consulta, você pode acessar a tela pelo menu Caixa, depois irá na opção Consultar Transações TEF, exibindo uma tela conforme imagem abaixo:
Clicando na opção de consulta das transações o sistema irá exibir a tela com os campos que deverá preencher para fazer a consulta.
Período: Pode estar informando datas específicas ou intervalos conforme desejar a consulta.
Cód. Autorização: Campo opcional, mas caso tiver e precisar preencher para puxar resultados específicos, pode utilizar.
Valor: Pode estar definindo valor para busca do resultado.
Nessa tela ainda existem algumas opções a mais para serem feitas, como por exemplo reimprimir uma via, consultar transação gerencial, ou operação ADM.



