Olá, seja bem-vindo à página do Pix (QrLinx) pelo DTEF/PAYKIT.
Aqui você encontrará as informações necessárias sobre a utilização do Pix através do Paykit (DTEF), incluindo configuração, parâmetros e funcionamento da integração no sistema.
| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
|
Objetivo
A funcionalidade Este documento tem como objetivo apresentar a implementação do Pix (QrLinx) pelo via DTEF/PAYKIT tem como objetivo permitir a realização de transações Pix diretamente através do Paykit (DTEF), utilizando a estrutura já integrada ao TAC no sistema EMSYS, demonstrando as configurações necessárias para utilização da funcionalidade e o comportamento do processo de pagamento durante as vendas.
Visão Geral
da SoluçãoO Paykit (DTEF) permiteA partir da versão 3.1.0.487 do TAC, disponibilizada por meio do atualizador automático, foi implementado o processamento de transações Pix através da funcionalidade QrLinx, utilizando a comunicação TEF já existente no sistema.Com isso, não é necessária instalação adicional ou utilização da integração antiga do QrLinx APIutilizando o QrLinx integrado ao Paykit.
Com essa funcionalidade, o pagamento Pix passa a ser realizado diretamente pela interface do PAYKIT, permitindo que o QR Code seja exibido durante o processo de venda para leitura e pagamento pelo cliente.
Para utilização do recurso, é necessário configurar o host QrLinx no TG3Config e informar corretamente a forma de pagamento vinculada ao Pix. Após a configuração, ao selecionar a forma de pagamento correspondente durante a venda, o sistema abrirá automaticamente a tela do PAYKIT contendo o QR Code para pagamento.
Também foi disponibilizado um parâmetro de licença responsável por forçar a utilização do QrLinx via DTEF, garantindo que o processamento das transações seja realizado pelo PAYKIT, independentemente das configurações padrão do sistema.
Configuração do QrLinx
Para habilitar a utilização do Pix pelo Paykit, é necessário alterar a configuração no TG3Config.
Acesse: TG3Config → Seleciona Host → QrLinx
É necessário informar somente o campo:
- Código Forma Pagamento.
- A forma de pagamento deve ser do tipo PL e possuir o parâmetro ind_qrlinx Qr Linx ativo no EMSys.
Essa configuração é a mesma já utilizada anteriormente no QrLinx API.
Os demais campos da configuração não são utilizados na integração via DTEF (Paykit).
Parâmetro de Licença
Foi disponibilizado o seguinte parâmetro de licença:
13187 - FORCAR QRLINX E WALLETS VIA DTEF
Funcionamento
Quando o parâmetro estiver configurado como “Sim”. O sistema irá considerar automaticamente a utilização do QrLinx via Paykit (DTEF), e o parâmetro do TG3Config será sobreposto.
Configuração sobreposta: TG3Config → Seleciona Host → QrLinx → QrLinx Ativo
Funcionamento da Venda
Durante o processo de venda, a integração do pagamento passa a ser realizada diretamente pelo Paykit.
Quando a forma de pagamento configurada para QrLinx for selecionada:
será Será exibida a tela do Paykit (DTEF);
o O QRCode será apresentado para leitura;a ;
- QR Code na tela do sistema;
- QR Code também exibido na pinpad.
A transação será processada pelo próprio Paykit.
Parâmetro de Licença
Foi disponibilizado o seguinte parâmetro de licença:
13187 - FORCAR QRLINX E WALLETS VIA DTEF
Funcionamento
Quando o parâmetro estiver configurado como “Sim”. O sistema irá considerar automaticamente a utilização do QrLinx via Paykit (DTEF), e o parâmetro do TG3Config será sobreposto.
Configuração sobreposta: TG3Config → Seleciona Host → QrLinx → QrLinx Ativo
Observação Final
A utilização do Pix via QrLinx depende da configuração correta da forma de pagamento no EMSys e da configuração do TEF no ambiente.- PIX seguirá rotina de cartão.
Cancelamento de venda
Ao cancelar a venda, a transação permanece em aberto. Por isso, é necessário realizar o cancelamento em duas etapas: Nota Fiscal e Pagamento (TEF/QR Code PIX).
Etapa 1 – Cancelamento da Nota Fiscal
Na tela principal do caixa, clique em F4 – Consultar NFe/NFCe localizado na barra inferior.
Na tela do Gerenciador de Documentos Fiscais, clique em Pesquisar para listar as notas emitidas.
Localize e selecione a nota que deseja cancelar.
Clique em Cancelar Nota (ícone de “X” vermelho).
Confirme a mensagem sobre o ambiente (homologação/produção) clicando em Yes (Sim).
Na janela Justificativa de Cancelamento, informe um motivo com no mínimo 15 caracteres e clique em OK.
O sistema exibirá a mensagem “Cancelamento de NF-e homologado”. Clique em F12 – Fechar.
Em seguida, será exibida a confirmação do cancelamento do pagamento via QR Code (PIX), com o número do NSU (Número Sequencial Único). Esse número deve ser anotado, pois será utilizado na próxima etapa.
Feche a tela do Gerenciador de Documentos Fiscais.
Etapa 2 – Cancelamento do Pagamento (TEF)
Na mesma tela principal do caixa e acesse o menu TEF e selecione Administrativo TEF.Escolha a opção 3 – Cancelamento Crédito/Débito e confirme em OK (ou F12).
Na tela Cancelamento TEF selecione a opção QR CODE e Confirme (F2 - OK)
Na tela de Transação de Cancelamento de Pagamento, selecione 2 – OUTRA TRANSAÇÃO.
Informe a data da transação no formato DD/MM/AA e confirme.
Digite o NSU anotado na etapa anterior e clique em OK.
Informe o valor total da transação e confirme.
Digite o motivo do cancelamento e clique em OK.
Informe o valor total da transação e confirme.
Digite o motivo do cancelamento e clique em OK.
O sistema iniciará a comunicação com a rede de pagamento com a mensagem “Solicitando cancelamento, aguarde...”.
Após validação, serão exibidas as mensagens “Cancelamento Aprovado” e “Imprimindo”.
Ao final, aparecerá a mensagem “Cancelamento efetuado com sucesso.”, concluindo o processo.
