4. Princípios básicos

4.1 Dinâmica de operação

Os componentes do TEF (PayGo Servidor e PayGo Cliente) são executados automaticamente ao Windows ser iniciado, porém permanecem em segundo plano, não requerendo nenhuma ação do usuário. Embora o PayGo Servidor possa iniciar automaticamente processos agendados pelas redes adquirentes ou pelo Estabelecimento, o PayGo Cliente, por sua vez, permanece no aguardo de um comando oriundo da Automação Comercial.

O acionamento do TEF pela Automação Comercial é realizado através da gravação de um arquivo de comando específico em determinado diretório. A gravação deste arquivo aciona imediatamente o TEF, que assume a interface com o usuário, ficando a partir deste momento a Automação Comercial em segundo plano. No final da operação de TEF, um arquivo de resposta é gravado em determinado diretório monitorado pela Automação Comercial, fazendo com que esta assuma novamente o controle, retornando o TEF ao estado de aguardo.

📘

Embora ambos os aplicativos Automação Comercial e TEF estejam sempre ativos (sendo executados) simultaneamente, em cada momento somente um deles está interagindo com o usuário, permanecendo o outro em segundo plano. O sincronismo entre as aplicações é realizado através da gravação sucessiva de arquivos.

4.2 Fluxo de uma transação

A figura abaixo ilustra a sequência de arquivos trocados durante uma transação de venda bem-sucedida (aprovada pela Rede Adquirente).

4.3 Tipos de transação

A Automação Comercial pode acionar o TEF para efetuar vários tipos de transação, no entanto destacam-se dois principais tipos:

→ Pagamento de mercadorias e/ou serviços adquiridos no Estabelecimento, associado a um cupom fiscal nos Estabelecimentos onde a legislação se aplicar, por exemplo:
• Venda com cartão de crédito/débito/etc.;
• Confirmação de pré-autorização;
• Venda com CPF (“primeira compra”);
• Venda com carteira digital;
• Financiamento

→ Outras transações e funções que não se encaixam no primeiro grupo, por exemplo:
• Pré-autorização;
• Consulta de saldo ou de financiamento;
• Pagamento de boleto/fatura;
• Recarga de celular pré-pago;
• Saque;
• Cancelamento de qualquer transação;
• Antecipação de vendas;
• Relatórios;
• Fechamento;
• Outras funções administrativas.

Os tipos de transação disponíveis variam muito dependendo da Rede Adquirente utilizada.

Para simplificar o entendimento, chamaremos a partir de agora estes 2 tipos de transação de Venda e Administrativa.

4.4 Comprovantes

O PayGo pode gerar vários tipos de comprovantes, dependendo do tipo de transação efetuada e da Rede Adquirente utilizada:

Comprovante Completo

→ Contém todas as informações para ambos o Cliente e o Estabelecimento. É tipicamente usado em impressoras com folha dupla, ou quando a Rede Adquirente não suporta os demais tipos de comprovante. Este é o único comprovante que é sempre gerado pelo PayGo

Comprovante diferenciado para o estabelecimento

→ Somente contém as informações relevantes para o Estabelecimento. Este comprovante é opcional, podendo ou não ser gerado pelo PayGo. A Automação Comercial deve preferencialmente emitir esta via do comprovante para o Estabelecimento, para não divulgar informações somente relevantes para o Cliente (por exemplo, o saldo do cartão).

Comprovante diferenciado para o cliente

→ Somente contém as informações relevantes para o Cliente. Este comprovante é opcional, podendo ou não ser emitido pelo PayGo. A Automação Comercial deve preferencialmente emitir esta via do comprovante para o Cliente, para reduzir o consumo de papel.

Comprovante reduzido

→ Somente contém as informações relevantes para o Cliente, excluindo informações que já estejam presentes no cupom fiscal (nome, endereço e CNPJ do Estabelecimento, data da transação, etc.). Se possível, este comprovante de até 5 linhas deve ser impresso pela Automação Comercial dentro do cupom fiscal, não num cupom fiscal vinculado. Este comprovante é opcional, podendo ou não ser emitido pelo PayGo, e restrito a transações de Venda. A Automação Comercial deve preferencialmente emitir esta via do comprovante para o Cliente, para reduzir o consumo de papel.

O PayGo gera comprovantes:

→ Para transações de Venda aprovadas: sempre;
→ Para transações Administrativas aprovadas: opcional;
→ Para transações (de Venda ou Administrativas) negadas: nunca.

Para transações de Venda, a Automação Comercial deve sempre imprimir 2 vias, a primeira para o Cliente, a segunda para o Estabelecimento. Estes comprovantes sempre devem ser vinculados ao documento fiscal correspondente.

Para transações Administrativas, a Automação Comercial deve imprimir uma primeira via (do Cliente), e perguntar para o operador se deseja imprimir a segunda via. Caso confirme a impressão da segunda via, imprimir a do Estabelecimento.

No caso da impressão de duas vias na mesma folha, a Automação Comercial deverá prever um mecanismo para separação das vias, seja de maneira automática (guilhotina) ou manual (pausa na impressão, prever um espaçamento de 5 linhas entre as vias).

Para que o PayGo possa formatar adequadamente os comprovantes para a Automação Comercial, esta deve informar no campo 706-000:

→ Se é apta a imprimir as vias diferenciadas (ao invés de duplicar a via única);
→ Se é apta a imprimir o cupom reduzido.

4.5 Diretórios para troca de arquivos

Para manter a compatibilidade com sistemas de TEF que substitui ou com os quais coexiste, o PayGo monitora e opera em diversos diretórios, dependendo das redes adquirentes habilitadas na solução.

Pelo mesmo motivo, é importante que o(s) diretório(s) de troca de arquivos utilizado(s) pela Automação Comercial seja(m) configurável(is), de acordo com as soluções de TEF contratadas pelo Estabelecimento.

Para integração com PayGo, recomenda-se o uso da pasta C:\PAYGO, pelos seguintes motivos:

→ É suportada em todas as instalações de ambos os produtos PayGo;
→ Atende todas as redes adquirentes habilitadas na solução;
→ Não depende de sistema intermediário para operar (módulo legado “Gerenciador Padrão”).

4.5.1 Exemplo

A Automação Comercial pode utilizar as seguintes pastas:

→ C:\PAYGO para acionar qualquer rede habilitada no PayGo;

→ C:\TEF_Dial para acionar:

• Qualquer rede habilitada no PayGo (se não estiver usando o módulo Gerenciador Padrão);
• As redes CIELO e REDECARD (se estiver usando o módulo Gerenciador Padrão);

→ C:\TEF_Disc para acionar as redes BANRISUL, TRICARD, POLICARD e VALECARD (e outras suportadas por soluções de TEF específicas), com uso do módulo Gerenciador Padrão secundário;

→ C:\TEF_CSHP para acionar a rede CREDI-SHOP.

4.5.2 Regras de uso

Independentemente do diretório utilizado, este contém duas pastas:

→ Req (por exemplo, C:\PAYGO\Req):

• Todos os arquivos gerados pela Automação Comercial para o PayGo são gravados nesta pasta.
• É de responsabilidade do PayGo excluir os arquivos gravados nesta pasta após lê-los.

→ Resp (por exemplo, C:\PAYGO\Resp):
• Todos os arquivos gerados pelo PayGo para a Automação Comercial são gravados nesta pasta.
• É de responsabilidade da Automação Comercial excluir os arquivos gravados nesta pasta após lê-los.

Observação: ao ser instalado, o PayGo automaticamente concede os direitos de leitura e gravação nas pastas acima para todos os usuários autenticados no computador.