TEF
- TEF - INFORMAÇÕES DIVERSAS
- TEF - APRESENTAÇÃO
- ADQUIRENTES HOMOLOGADAS COM SITEF E MP15
- SOLICITAÇÕES NLÓGICOS
- INTERFACE DE RELATÓRIOS - SITEF EXPRESS
- ADQUIRENTES TICKET E VR
- Pré-Datado Vero/Banrisul
- SOLICITAÇÕES DE TEF
- ADQUIRENTES CREDENCIADAS A FISERV/SITEF EXPRESS PARA TRANSAÇÕES TEF
- SOLICITAÇÃO DE TEF (FUNCIONÁRIOS CPLUG)
- SOLICITAÇÕES DE PIX
- BANCOS CREDENCIADOS À FISERV / SITEF EXPRESS PARA TRANSAÇÕES PIX
- SOLICITAÇÃO DE PIX (FUNCIONÁRIOS CPLUG)
- PIX - ITAÚ - VÍNCULO DE INTEGRADOR SITEF
- PIX - BRADESCO - VÍNCULO NO INTERNET BANKING
- PIX -SICREDI - VÍNCULO NO INTERNET BANKING
- CREDENCIAMENTO PIX - SICOOB - COLETA DE DADOS
- GERAÇÃO E COLETA DE DADOS - PIX - BANCO DO BRASIL
- COMO ADQUIRIR ACESS TOKEN DO MERCADO PAGO PARA RECEBER PIX NO AUTOATENDIMENTO?
- SOLICITAÇÕES DE PARCEIROS E REVENDEDORES
- INSTALAÇÃO TEF
- TRATATIVA DE ERROS
- GSURF - DICAS E TRATATIVAS
- COLETA DE EVIDÊNCIAS
- RETORNO DE ERRO: DADOS LÓGICOS - SOLICITAÇÕES TEF
- RETORNO DE ERRO: FALHA NAS CREDENCIAIS - SOLICITAÇÕES PIX
- RETORNO DE ERRO: CNPJ EXISTENTE NA FISERV - SOLICITAÇÕES TEF
- INSTALAÇÃO PIX
- Integrações com POS
TEF - INFORMAÇÕES DIVERSAS
TEF - INFORMAÇÕES DIVERSAS
TEF - APRESENTAÇÃO
APRESENTAÇÃO TEF EM PDF - ACESSE AQUI.
ADQUIRENTES HOMOLOGADAS COM SITEF E MP15
Rede, Stone, Cielo, Safra, Vero, Getnet, Pagseguro
SOLICITAÇÕES NLÓGICOS
1. Atendimento de demandas e SLA
-
-
Atendimento em horário comercial regular - 09:00 as 17:00 - Intervalo 01 hora de almoço
-
SLA de 08 horas úteis para resposta de solicitações
-
2. Solicitações
Os Times de Suporte e/ou Times de Implementação devem realizar a Solicitação de PIX via TICKET pelo MOVIDESK, utilizando as respectivas Macros em seus respectivos cenários:
(NLOGICOS) - 1º Solicitação de TEF
(NLOGICOS) - 1º Solicitação de PIX
(NLOGICOS) - Solicitação de roteamento de bandeiras para múltiplas adquirentes
(NLOGICOS) - Solicitação de troca de adquirente TEF
(NLOGICOS) - Solicitação de troca de Chave PIX ou BANCO
3. Consulta de solicitações:
Para facilitar o acompanhamento, criamos um Painel de Consulta no MOVIDESK, com título: NLÓGICOS (TEF E PIX)
4. Utilização slack: cplug-ppi-comunica
-
Solicitação via ticket enviada, no caso de real urgência, reportar no grupo slack: cplug-ppi-comunica, neste caso solicitação será atendida o mais breve possivel
Informações atualizadas em 11/04/2025
INTERFACE DE RELATÓRIOS - SITEF EXPRESS
?️ Podcast: Escute para aprender
?️ Vídeo: Assista para entender
Esta interface é crucial para a operação do cliente e para as equipes internas da ConnectPlug, oferecendo uma visão gerencial e analítica das transações feitas pelo Módulo de TEF - Transferência Eletrônica de Fundos.
Impactos por Área:
- Comercial: Destaca a segurança e a automação (eliminação de erros manuais) do processo de pagamento, funcionando como um diferencial competitivo.
- Implantação: Facilita a capacitação do cliente no uso da plataforma, ensinando a consulta de transações e o gerenciamento de problemas como Transações Pendentes, o que reduz futuras demandas de suporte.
- Suporte: É a ferramenta principal para a resolução de problemas, permitindo identificar rapidamente a origem de divergências (comunicação ConnectPlug/Fiserv ou erros de adquirente/cartão).
Gerenciamento de Transações Pendentes: O ponto de maior atenção é o gerenciamento das Transações Pendentes. Quando uma transação é julgada suspeita pela adquirente ou banco, o cliente tem um prazo estabelecido pela Fiserv para validá-la ou cancelá-la. Caso o portal não seja acompanhado e o prazo exceda, a transação pode ser efetivada ou cancelada pela Adquirente/Banco. Para orientar o cliente em como tratar transações pendentes, utilize o vídeo abaixo:
Pré-Requisitos
Para que o cliente (e, consequentemente, os analistas internos) possam utilizar a Interface de Relatórios da Sitef Express, os seguintes pontos devem estar atendidos:
- O cliente deve ter o Módulo TEF contratado em seu plano.
- O processo de Credenciamento e Instalação TEF deve ter sido finalizado com sucesso no ERP e no terminal (PDV 2.0 ou TOTEM).
- O cliente deve ter recebido as credenciais de acesso (e-mail, nome e senha) no momento do credenciamento TEF/PIX, que são enviadas pela própria Fiserv, permitindo o login no portal.
Passo a Passo: Utilizando a Interface de Relatórios
Este guia tem como objetivo capacitar a equipe CPlug e os clientes sobre como acessar, filtrar e analisar transações.
- Acesso e Login:
◦ Acesse o link do portal Sitef Express - Clique aqui!!!
◦ Insira as credenciais de login e realize a validação por dupla autenticação (código do authenticator).
▪ Pesquise o cliente utilizando o Código da Loja - IDSITEF ou o CNPJ.
▪ Localize o cliente e, no menu Ações, clique em Acessar Interface de Relatórios.
- Visualização e Seleção da Loja:
◦ Na interface de relatórios, vá em Relatórios > Transações.
◦ Filtro por Loja (Cenário Multi-Loja): Se o cliente possui múltiplos estabelecimentos (franquia), utilize o filtro Loja para refinar a busca, pois ele atuará como um filtro macro.
▪ Selecione a loja desejada na lista Disponível e adicione-a ao campo Selecionado.
- Definição do Período de Busca:
◦ Defina o Período Inicial e o Período Final.
Dica de Suporte: É possível refinar a busca por hora, minuto e segundo (por exemplo, entre 13:00 e 14:00 de um dia específico), o que é útil para clientes com alto volume de transações.
Lembrete: A plataforma permite pesquisar transações de no máximo três meses. Caso precise de dados de períodos distintos (ex: 29 de julho a 24 de setembro), a busca precisa ser fracionada por mês.
- Aplicação de Filtros Secundários:
◦ Para clientes multiadquirentes, utilize o campo Redes para filtrar a transação por adquirente específica (ex: Cielo, Stone).
◦ Utilize o campo Produto para filtrar por bandeira específica (ex: Mastercard, Visa).
◦ Utilize o campo Estado da Transação para refinar a pesquisa por: Validadas, Canceladas, Estornadas ou Pendentes.
- Pesquisa e Análise de Dados:
◦ Clique em Pesquisar.
◦ A tela exibirá o Resumo dos Quantitativos, mostrando o número e valor de transações validadas, pendentes e não validadas.
◦ Vá para a aba Detalhes para ver a lista de transações.
◦ Clique no ícone "+" ao lado da transação desejada para acessar o detalhamento completo.
◦ Analise o campo Código estado e resposta para identificar a causa de erros (ex: "negada pela adquirente", "senha incorreta").
- Exportação do Relatório:
◦ Para baixar os dados, clique em Gerar Arquivo, selecione as colunas desejadas e o formato (ex: PDF ou .TXT).
◦ O download não é imediato; a plataforma faz uma solicitação de arquivo.
Dúvidas Frequentes
Este tópico visa esclarecer as regras internas e os pontos críticos de atenção para o Suporte e Implantação.
- Gestão de Transações Pendentes (Responsabilidade do Cliente): A Interface de Relatórios é o único local onde o cliente pode aceitar, estornar ou cancelar uma transação marcada como "Pendente" pela adquirente/banco. É vital orientar o cliente a acessar o portal regularmente, pois o prazo para esta validação é determinado pela Fiserv. Caso o portal não seja acompanhado e o prazo exceda, a transação pode ser efetivada ou cancelada pela Adquirente/Banco. Nenhum analista da ConnectPlug tem permissão de segurança para realizar essa confirmação ou cancelamento pelo cliente.
- Limitações do Filtro de Período: A plataforma Fiserv/Sitef Express permite a consulta de transações apenas dos últimos três meses. Além disso, não é possível pesquisar meses distintos em um único filtro; deve-se fracionar a pesquisa por mês vigente (ex: buscar agosto e depois buscar setembro separadamente).
ADQUIRENTES TICKET E VR
?️ Podcast: Escute para aprender
?️ Vídeo: Assista para entender
? Contexto/Por que Fazer
Este guia é essencial para o time de Suporte, Comercial e Implementação da ConnectPlug, pois detalha uma mudança crítica na forma como as transações das empresas Ticket e VR (e suas variações) são processadas no ambiente Fiserv/Sitef Express.
O Cenário Anterior: Historicamente, as transações de Ticket e VR eram tratadas como bandeiras transacionadas dentro de uma adquirente principal (por exemplo, Stone ou Rede).
A Mudança e o Impacto Operacional: A partir de setembro de 2025, a Fiserv passou a tratar Ticket e VR como adquirentes exclusivas, com um módulo próprio.
Por que a Configuração é Importante (Foco na Solução ConnectPlug): Para que o cliente consiga transacionar Ticket e VR, é obrigatório que ele opere em um cenário multiadquirentes. A correta coleta e configuração dos dados lógicos para cada uma dessas empresas, agora como adquirentes separadas, é vital para manter a funcionalidade do módulo TEF da ConnectPlug.
O time da ConnectPlug deve estar ciente de que, internamente, configuraremos a adquirente primária e as adquirentes Ticket e/ou VR como entidades distintas em nosso ambiente Fiserv.
✅ Pré-Requisitos
Antes de iniciar a solicitação de credenciamento ou a configuração de um cliente que deseja transacionar Ticket e VR, certifique-se de que os seguintes pontos foram coletados e confirmados:
- Contratos com as Novas Adquirentes: O cliente deve ter contatado a Ticket e/ou a VR e fechado um contrato de adquirente (já que elas não são mais apenas bandeiras).
- Coleta de Dados Lógicos: O analista (Suporte/Implantação) deve coletar os Dados Lógicos de todas as adquirentes necessárias:
◦ Dados lógicos da adquirente primária (ex: Stone, Rede, Getnet, etc.).
◦ Dados lógicos da Ticket (se aplicável).
◦ Dados lógicos da VR (se aplicável):
- Código: SmartNet: 07 dígitos numéricos
Importante: Se o cliente utiliza uma adquirente principal (A), Ticket (B) e VR (C), o analista deve coletar três conjuntos de dados lógicos para configurar três adquirentes diferentes.
⚙️ Passo a Passo (Solicitação Interna)
O procedimento a seguir destina-se ao analista (Suporte ou Implantação) para solicitar a configuração correta no ambiente ConnectPlug/Fiserv, priorizando a coleta de dados de um cenário multiadquirentes.
- Confirmação do Cenário Multiadquirentes:
◦ Confirme com o cliente a necessidade de transacionar Ticket ou VR.
◦ Contextualize o cliente sobre a mudança de status dessas empresas para adquirentes (a partir de Setembro/2025).
- Coleta Abrangente dos Dados Lógicos:
◦ Solicite e valide os dados lógicos da adquirente principal (ex: Rede).
◦ Solicite e valide os dados lógicos específicos da Ticket:
- Código: SmartNet: 07 dígitos numéricos
◦ Solicite e valide os dados lógicos específicos da VR.
- Abertura da Solicitação (Time NLogicos):
◦ Abra o ticket de solicitação de credenciamento, sinalizando claramente o cenário multiadquirentes.
◦ Inclua no chamado todos os conjuntos de dados lógicos coletados (Adquirente Principal, Ticket e/ou VR).
- Finalização de Solicitação
◦ Após a atuação do time Nlógicos, o ticket será finalizado.
❓ Dúvidas Frequentes
- O que significa exatamente que Ticket e VR "passam a ser adquirentes"?
Significa que elas não são mais tratadas como bandeiras secundárias transacionadas dentro de uma adquirente primária (como Stone ou Rede). Agora, elas exigem um módulo exclusivo e são configuradas no ambiente Fiserv como adquirentes independentes, forçando o cliente a operar em um cenário multiadquirentes se ele quiser utilizá-las junto a outras.
- O time da ConnectPlug precisa de dados lógicos adicionais do cliente?
Sim, é necessário coletar os dados lógicos do contrato da adquirente principal (ex: Getnet) e, separadamente, os dados lógicos fornecidos pela Ticket e/ou pela VR. Para a configuração, a ConnectPlug precisa de um conjunto de dados para cada empresa envolvida.
- Essa mudança é uma limitação da ConnectPlug?
Não. Esta é uma alteração comunicada pela Fiserv, a TEF House parceira da ConnectPlug, que redefine o tratamento dessas empresas no seu ambiente a partir de setembro de 2025. Nosso papel é configurar a solução ConnectPlug para se adequar a essa nova regra, garantindo a transação.
- Essa regra se aplica às variações (por exemplo, Ticket Alimentação)?
Sim. O comunicado se refere à Ticket e VR junto com as suas variações, que também passam a exigir este tratamento como adquirentes
Pré-Datado Vero/Banrisul
SOLICITAÇÕES DE TEF
SOLICITAÇÕES DE TEF
ADQUIRENTES CREDENCIADAS A FISERV/SITEF EXPRESS PARA TRANSAÇÕES TEF
Cielo
Terminal lógico (código numérico de 8 dígitos)
Cooper Cred
Código de estabelecimento (código numérico de 15 dígitos)
Getnet (Santander)
Código de estabelecimento ou EC (código numérico de 15 dígitos, em alguns casos é informado 08 dígitos para ser completado com "zeros a esquerda")
Terminal lógico (código numérico de 08 Dígitos iniciando com sigla TF)
PagSeguro (Pagbank)
Código de estabelecimento (código numérico de 15 dígitos iniciando com a letra T)
Rede (Itaú)
Código de estabelecimento ou número lógico (código numérico de 15 dígitos)
Safra
Código de estabelecimento (código numérico de 15 dígitos)
Terminal lógico (código numérico de 8 dígitos)
Sipag / Sicoob
Estabelecimento (código numérico de 15 dígitos)
-> Configurado via CARDSE e roteamento apenas para as bandeiras que FISERV disponibiliza para SIPAG/SICOOB:
AMEX
CABAL CREDITO, DEBITO E VOUCHER
ELO CREDITO E DEBITO
ELO VOUCHER
MASTER
MASTER VOUCHER
TICKET
VISA CREDITO
VISA VOUCHER
VR
CAPPTA (Subadquirente)
Estabelecimento (0 + CNPJ)
-> Configurado via CARDSE e roteamento apenas para as bandeiras que FISERV disponibiliza para CAPPTA:
Alelo
Amex
Banescard Debito
Banescard Crédito
Cabal Credito
Cabal Debito
Cabal Voucher
CredSystem(Mais)
CredZ
Dinners Credito
Elo Credito
Elo Debito
Elo Voucher
Goodcard Debito
Goodcard Credito
Goodcard Voucher
Greencard
Hiper Credito
Hiper Debito
JCB Credito
Maestro
Master Voucher
Mastercard
Sorocred Credito
Sorocred Debito
Sorocred Voucher
Verdecard
Verdecard Debito
Visa Credito
Visa Electron
Sorocred
Código de estabelecimento (código alfanumérico de 15 dígitos)
Stone
SAK (código alfanumérico de 32 dígitos)
Stone Code (código numérico de 9 dígitos)
Vero (Banrisul)
Código de estabelecimento (código numérico de 15 dígitos)
Código da rede (código numérico de 11 dígitos)
Sicredi / Caixa (Adquirência) / Bin
Código de estabelecimento (código numérico de 15 dígitos)
Terminal lógico (código numérico de 08 Dígitos iniciando com sigla TF)
BK Bank
Código Estabelecimento ou Código MID (número de 15 dígitos)
ID Checkout ou Código TID (código numérico de 8 dígitos)
Maxiscard
Código Estabelecimento (código alfanumérico de 10 dígitos que se inicia com as siglas MC)
Código BIN (código numérico de 7 dígitos)
Ticket -Apenas cenário Multiadquirentes - Veja este artigo para ter mais informações!!
- Código: SmartNet: 07 dígitos numéricos
InterPag
-> Configurado via CARDSE e roteamento apenas para as bandeiras que FISERV + INTERPAG disponibilizam para INTERPAG:
(Código de estabelecimento) -> 0 + CNPJ do cliente (na configuração do CARDSE)
Bandeiras disponíveis para roteamento:
AMEX
ELO DEBITO
ELO CREDITO
ELO VOUCHER
MAESTRO
MASTER VOUCHER
MASTERCARD
VISA CREDITO
VISA ELECTRON
Mercado Pago Adquirência
-> Configurado via CARDSE e roteamento apenas para as bandeiras que FISERV + Mercado Pago Adquirência disponibilizam para Mercado Pago Adquirência:
(Código de estabelecimento) -> 0 + CNPJ do cliente (na configuração do CARDSE)
Bandeiras disponíveis para roteamento:
ALELO
AMEX
CABAL
ELO DEBITO
ELO CREDITO
ELO VOUCHER
HIPER CREDITO
MAESTRO
MASTER VOUCHER
MASTERCARD
SODEXO
TICKET
VISA CREDITO
VISA ELECTRON
VR
OBS: Para funcionar como adquirente, o cliente precisa contratar Mercado Pago Adquirência e não somente Mercado Pago, pois são propostas distintas dentro desta marca.
SOLICITAÇÃO DE TEF (FUNCIONÁRIOS CPLUG)
Os Times de Suporte e/ou Times de Implementação devem realizar a Solicitação de TEF via TICKET pelo MOVIDESK, utilizando a Macro: (NLOGICOS) - 1ºSolicitação de TEF
As solicitações enviadas com Bancos Homologados, seguirão o SLA de 08 horas úteis.
Consulta de solicitações
Para facilitar o acompanhamento, criamos um Painel de Consulta no MOVIDESK, com título: NLÓGICOS (TEF E PIX)
Informações atualizadas em 11/04/2025
SOLICITAÇÕES DE PIX
SOLICITAÇÕES DE PIX
BANCOS CREDENCIADOS À FISERV / SITEF EXPRESS PARA TRANSAÇÕES PIX
Itaú Unibanco
É obrigatório que cliente realize um Vínculo entre Bankline ou Portal com a FISERV / SITEF EXPRESS - Veja este artigo para ter detalhes!
-
Abaixo as credenciais exigidas:
-
Tipo da Chave PIX
-
Chave PIX
-
Cidade
-
Banco SICREDI
É obrigatório que cliente realize um Vínculo entre Bankline ou Portal com a FISERV / SITEF EXPRESS - Veja este artigo para ter detalhes!
-
Abaixo as credenciais exigidas:
-
CNPJ da conta transacional
-
Cliente ID
-
Cliente Secret
-
Tipo da Chave Pix
-
Chave PIX
-
Cidade
-
Banco do Brasil
É obrigatório que cliente realize um Vínculo entre Bankline ou Portal com a FISERV / SITEF EXPRESS - Veja este artigo para ter detalhes!
-
Abaixo as credenciais exigidas:
-
Cliente ID
-
Cliente Secret
-
Tipo da Chave Pix
-
Chave PIX
-
Cidade
-
Banco SICOOB
É obrigatório que cliente realize um Vínculo entre Bankline ou Portal com a FISERV / SITEF EXPRESS - Veja este artigo para ter detalhes!
-
Abaixo as credenciais exigidas:
-
CNPJ da conta transacional
-
Cliente ID
-
Cliente Secret
-
Tipo da Chave Pix
-
Chave PIX
-
Cidade
-
Banco Bradesco
É obrigatório que cliente realize um Vínculo entre Bankline ou Portal com a FISERV / SITEF EXPRESS - Veja este artigo para ter detalhes!
-
Abaixo as credenciais exigidas:
-
Tipo da Chave PIX
-
Chave PIX
-
Cidade
-
Banco Santander
-
Abaixo as credenciais exigidas:
-
Cliente ID
-
Cliente Secret
-
Tipo da Chave Pix
-
Chave PIX
-
Banco VerdeCard / Quero Quero Pag
-
Abaixo as credenciais exigidas:
-
Cliente ID
-
Cliente Secret
-
Tipo da Chave Pix
-
Chave PIX
-
CIELO
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
PAGSEGURO
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
Bancos não homologados, porém com possibilidade de tentativa de configuração junto a FISERV / SITEF EXPRESS, sem garantia de funcionamento:
A configuração pode ser tentada, mas não há garantia de funcionamento.
Bancos possíveis:
Ailos, Banco Original, Cielo, Efí (Gerencianet), PagSeguro, Realize, Senff, Safra, Caixa, Banrisul, Cresol, Unicred
? Orientações para bancos não homologados:
-
Informar ao cliente que o processo pode não ter sucesso ou prioridade.
-
Solicitar o máximo de informações do banco + chave PIX.
-
Caso não seja possível validar, orientaremos a migrar para um banco homologado.
AILOS
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
BANCO ORIGINAL
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
EFI
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
REALIZE
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
SENFF
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
SAFRA
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
CAIXA
-
Tipo da Chave Pix:
-
Chave PIX:
BANRISUL
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
CRESOL
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
UNICRED
-
Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
Mercado Pago (utilização funcional apenas no autoatendimento com acess token ao invés de configuração PIX tradicional, sem possibilidade de uso no PDV 2.0)
Observação importante:
Quando recebemos uma solicitação de PIX de um banco não homologado, é crucial informar ao cliente que, embora tentemos o credenciamento, o processo não é garantido.
Para prosseguir, o solicitante deve coletar informações detalhadas sobre o banco em questão e a chave PIX associada.
A submissão dessa solicitação deve ser feita por e-mail, não por meio de formulário.
É importante ressaltar que o time de PPI tentará para validar a solicitação junto ao FISERV / SITEF EXPRESS. Contudo, é crucial comunicar ao cliente que este processo pode não ser prioritário e que a validação pode ser um processo lento.
Caso a validação não tenha sucesso, orientaremos o cliente a considerar a escolha de um dos bancos homologados, garantindo assim uma transação segura e eficiente.
SOLICITAÇÃO DE PIX (FUNCIONÁRIOS CPLUG)
Os Times de Suporte e/ou Times de Implementação devem realizar a Solicitação de PIX via TICKET pelo MOVIDESK, utilizando a Macro: (NLOGICOS) - 1ºSolicitação PIX
Abaixo seguem os dados a serem providenciados para cada banco:
Confirmar junto ao cliente o Vínculo de Parceiro no Bankline (Acesse este Link para Artigo que demonstra como realizar Vínculo)
Chave Pix
Cidade
Cliente ID
Client Secret
Se cliente tiver dificuldades em se obter dados acima (Cliente ID e Secret) acesse este link para um Artigo de ajuda
Chave Pix
Cidade
CNPJ Conta Transacional (É preciso validar o CNPJ da Conta Transacional junto a Fiserv antes de prosseguir com a Criação da Credencial Pix)
Chave Pix
Cidade
Client ID:
Client Secret: o código é igual ao Cliente ID
CNPJ Conta Transacional
Confirmar junto ao cliente o Vínculo no Internet Banking (Acesse este Link para Artigo que demonstra como realizar Vínculo)
Chave Pix
Cidade
Confirmar junto ao cliente o Vínculo de Parceiro no Bankline (Acesse este Link para Artigo que demonstra como realizar Vínculo)
Chave Pix
Cidade
Client ID
Client Secret
Chave Pix
Cidade
- Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
- Cliente ID:
-
Cliente Secret:
-
Tipo da Chave Pix:
-
Chave PIX:
Abaixo temos a relação de alguns bancos que ainda não tivemos um credenciamento validado, mas constam na SITEF como homologados:
-
-
Ailos
-
Banco Original
-
Efí (Gerencianet)
-
Mercado Pago
-
Realize CFI
-
Senff
-
Tribanco
-
Unicred
-
Verdecard
-
Se recebermos uma solicitação de PIX de um destes bancos acima, devemos informar ao cliente que não se trata de um banco homologado, mas podemos realizar a tentativa de credenciamento.
Neste caso o solicitante precisa coletar o máxima de informações referente ao Banco e Chave PIX, e incluir as informações no respectivo ticket.
O time de PPI tentará realizar a validação junto a SITEF, neste cenário não será possivel realizar de maneira prioritária e o solicitante e cliente deverão estar cientes que este processo poderá ser lento e se não houver sucesso, orientaremos o cliente a escolher um dos bancos homologados.
As solicitações enviadas com Bancos Homologados, seguirão o SLA de 08 horas úteis.
Consulta de solicitações
Para facilitar o acompanhamento, criamos um Painel de Consulta no MOVIDESK, com título: NLÓGICOS (TEF E PIX)
Informações atualizadas em 06/02/2026
PIX - ITAÚ - VÍNCULO DE INTEGRADOR SITEF
Passo a passo à ser realizado pelo cliente no Bankline Itaú Unibanco:
-
Login e Página de Cobrança:
Caminho da Tela abaixo: Bankline>Cobrança>Integradores Pix 
-
Oriente o cliente a se logar no Bankline Corporativo
-
Após login, acessar Aba Cobrança>Ir para a página de cobrança
-
Em Cobrança, escolher opção Integradores Pix
-
Seleção Chave PIX:
Caminho da Tela abaixo: Bankline> Integradores Pix>Minhas Chaves>Vincular com Integrador
-
Selecionar a Chave PIX que deseja liberar na TEF e clicar em Detalhe da Chave
-
Selecionar opção Vincular com Integrador
-
Vínculo Integrador e Permissão:
Caminho da Tela abaixo: Bankline>Vincular com Integrador>Escolha dos Integradores
-
Selecionar o seguinte integrador: Fiserv ou Software Express
-
Definir a permissão como Acesso Completo
-
Validação e Confirmação:
Caminho da Tela abaixo: Bankline>Vínculo de Integrador>Validação
-
Validar a operação com a Autenticação de Segurança
-
Confirmar Vínculo com tela de Solicitação Confirmada
-
Dúvidas comuns:
-
É possível vincular o uma chave de uma Conta de Pessoa Física?
-
Atualmente estas opções de vínculo são disponibilizadas apenas para Contas Jurídicas
-
-
PIX - BRADESCO - VÍNCULO NO INTERNET BANKING
-
Passo a passo à ser realizado pelo cliente no Internet Banking - Bradesco
-
Oriente o cliente a acessar o Internet Banking - BRADESCO NET EMPRESA com os dados de usuário e conta. Se necessário compartilhe este link com o cliente!
-
Este acesso deve ser feito exclusivamente no ambiente DESKTOP, na versão do aplicativo para celular os recursos não são exibidos corretamente.
-
O cliente deve selecionar a opção PIX NA MAQUININHA DE CARTÃO (POS/TEF)
-
Deverá ser selecionado a opção de SOLICITAR CADASTRO
-
Para o credenciamento de PIX na TEF, o cliente deverá escolher TEF (SOLUÇÃO DE VENDAS INTEGRADAS)
-
A opção SOFTWARE EXPRESS deverá ser selecionada e após isso, clicar em CADASTRAR
-
Na próxima tela, deverá ser escolhido a CHAVE PIX que deseja utilizar no credenciamento, a respectiva chave já precisa estar cadastrada e ativa
-
Oriente o cliente a copiar estas credenciais para um local seguro e repassar as mesmas credenciais para que você insira no formulário de credenciamento de PIX.
Dúvidas comuns:
-
É possível vincular o uma chave de uma Conta de Pessoa Física?
-
Atualmente estas opções de vínculo são disponibilizadas apenas para Contas Jurídicas
-
PIX -SICREDI - VÍNCULO NO INTERNET BANKING
-
Passo a passo à ser realizado pelo cliente no Internet Banking - SICRED
Etapa 1
-
Oriente o cliente a acessar o Internet Banking - SICRED com os dados de COOPERATIVA E CONTA . Este acesso deve ser realizado por um perfil de USUÁRIO MASTER.
-
O cliente deve selecionar o menu OUTROS SERVIÇOS / ACESSO API PIX / GERAR CREDENCIAIS.
- Na lista CERTIFICADO/PROVEDOR oriente o cliente a selecionar o provedor: SOFTWARE EXPRESS e confirmar a escolha.
Etapa 2
-
O cliente deverá marcar a opção AMBIENTE VIRTUAL DE PRODUÇÃO (ambiente de armazenamento de dados)
-
Oriente o cliente a marcar o campo de ACEITE DO TERMO DE USO e avançar a etapa para prosseguir com a solicitação
-
Neste momento o cliente deverá informar os números referentes a sua ASSINATURA ELETRÔNICA e finalizar a solicitação.
-
Será gerado as credenciais: CLIENT_ID e CLIENT_SECRET
-
Oriente o cliente a copiar estas credenciais para um local seguro (o aplicativo não permitirá a consulta posterior destas credenciais) e repassar as mesmas credenciais para que você insira no formulário de credenciamento de PIX.
Dúvidas comuns:
-
É possível vincular o uma chave de uma Conta de Pessoa Física?
-
Atualmente estas opções de vínculo são disponibilizadas apenas para Contas Jurídicas
-
CREDENCIAMENTO PIX - SICOOB - COLETA DE DADOS
-
Passo a passo à ser realizado pelo cliente no PORTAL DEVELOPERS SICOOB e APP SICOOB
-
Para visualizar o documento completo feito pelo SICOOB - Acesse este link!
1. Portal Developers - SICOOB
-
Acesso ao Portal Developers - SICOOB: Orientar acesso com os dados de usuário e conta.
-
-
Se for primeiro acesso, realizar todo cadastro, incluindo criação de senha de acesso
-
Observação importante: Cadastro deve ser realizado no tipo de PESSOA JURÍDICA
-
-
Gerar Aplicativo:
Caminho da tela abaixo: Portal Developers SICOOB
-
O cliente deve selecionar a opção GERAR APLICATIVO
-
Aba Informações:
Caminho da tela abaixo: Portal Developers SICOOB>Novo Aplicativo>Informações
-
-
-
Preencher todos campos
-
Sugestão de Nome: Integração API
-
Sugestão de Descrição do Aplicativo: PIX CPLUG
-
-
-
Aba Segurança:
Caminho da tela abaixo: Portal Developers SICOOB>Novo Aplicativo>Segurança
-
-
-
Definir integração por EMPRESA PARCEIRA: SOFTWARE EXPRESS
-
-
-
Aba APIs:
Caminho da tela abaixo: Portal Developers SICOOB>APIs
-
-
-
Escolher APIs de Cooperado: PIX
-
-
-
Aba Confirmação:
Caminho da tela abaixo: Portal Developers SICOOB>Confirmação
-
-
-
Validar dados de Nome de Cooperado, Cooperativa, Conta Corrente, Empresa Parceira: SOFTWARE EXPRESS
-
Coletar CLIENT ID: O mesmo dado de CLIENT ID deverá ser informado em CLIENT SECRET
-
-
2. APP SICOOB
-
Acesso ao APP SICOOB: Orientar acesso com os dados de usuário e conta.
-
-
Devido a proteção e segurança de dados, não temos prints do APP SICOOB
-
-
-
Procurar TRANSAÇÕES PENDENTES / DETALHAMENTO: Acessar Autorização para uso de APIs e CONFIRMAR AUTORIZAÇÃO DE USO
-
Acessar CHAVE PIX já existentes ou criar CHAVE PIX, coletar TIPO DA CHAVE e CHAVE PIX
GERAÇÃO E COLETA DE DADOS - PIX - BANCO DO BRASIL
-
Passo a passo à ser por clientes que utilizam a solução do Banco do Brasil e desejam utilizar PIX na TEF via SITEF EXPRESS.
-
Acesso o documento completo pelo link - Clique para acessar!
1. Cadastro de Chave PIX
Caminho da Tela abaixo: Bankline>PIX>Chaves PIX>Cadastrar/Gerenciar Chaves
-
Nosso cliente deverá utilizar uma conta do tipo pessoa Jurídica, os tipos de chaves possíveis são:
-
-
CNPJ
-
Email
-
Celular
-
Chave aleatória
-
-
-
Observação importante: O cadastro da CHAVE PIX no aplicativo do Bankline deverá ser feito por um usuário: COM PLENOS PODERES ou PODERES PARA REALIZAR PAGAMENTOS.
2. Criação de Aplicação
Caminho da Tela abaixo: Bankline> Parceiro Pix>Minhas Chaves>Vincular com Parceiro
-
Usuário deverá acessar PORTAL DEVELOPERS BB - Clique aqui para acessar!
-
Acesso deverá ser feito via CPF do usuário COM PLENOS PODERES ou PODERES PARA ASSINATURA DE CONVÊNIOS COM O BB.
-
Acessar Aplicações>Nova Aplicação>
-
Não é necessário preenchimento dos campos URL do Icone e URL de Callback
-
Selecionar API>PIX>Criar
3. Coleta de Credenciais:
Caminho da Tela abaixo: Portal Developers BB
-
Com aplicação selecionada, no menu lateral esquerdo, clique em PRODUÇÃO>Insira o CNPJ>Pesquisar CNPJ
-
Confirme dos dados cadastrais e clique em PRÓXIMO
-
Clique em SOLICITAR PRODUÇÃO
-
Na sessão de NOTIFICAÇÕES DO PORTAL, acesse o TERMO DE ADESÃO A API, realize a assinatura digital.
-
Clique em CREDENCIAIS no menu lateral esquerdo, nesta tela o usuário terá acesso ao CLIENT ID e CLIENT SECRET, o mesmo deverá copiar estes dados e informar ao solicitante do TIME CPLUG, juntamente com os demais dados necessários.
Dúvidas Comuns:
-
É possível vincular o uma chave de uma Conta de Pessoa Física?
-
Atualmente estas opções de vínculo são disponibilizadas apenas para Contas Jurídicas
-
COMO ADQUIRIR ACESS TOKEN DO MERCADO PAGO PARA RECEBER PIX NO AUTOATENDIMENTO?
Atualmente, é possível utilizar o Mercado Pago como banco recebedor de PIX através da aplicação de autoatendimento, a partir da versão 1.17.1.
Neste cenário, a configuração é feita utilizando o Access Token, dispensando o uso da Sitef Express como integradora de pagamento.
Este tutorial tem como objetivo demonstrar como adquirir o Access Token para configurar no contrato de cartões, utilizando o MercadoPago como provedor de pagamento.
1 - Logar no portal do Mercado Pago.
2 - Clicar em Meu Negócio
2.1 - Clicar em Configurações
3 - Em gestão e administração, clique em Credenciais:
4 - E escolha a opção de Credenciais de Produção
.png)
5 - Copie o Acess Token
.png)
Após completar esses passos, proceda criando um contrato de cartões no ERP, selecionando o provedor MercadoPago e inserindo o Access Token no campo designado.
No contrato de cartões, adicione o método de pagamento PIX e salve as alterações.
.png)
Em seguida, sincronize e habilite Criar Pos Mercado Pago na área ADM do Totem V2 ->
OBSERVAÇÕES:
1 - Não é possível utilizar Mercado Pago e outro banco (via integradora de pagamento Sitef Express), concomitantemente.
2 - Não habilitar o método de pagamento PIX, em métodos de pagamento, na configuração do terminal de autoatendimento.
3 - Essa configuração é válida apenas para a aplicação de autoatendimento, versão 1.17.1 em diante.
SOLICITAÇÕES DE PARCEIROS E REVENDEDORES
Artigos relacionados a solicitações e tratativas relacionadas a TEF e PIX, para uso exclusivo de PARCEIROS E REVENDEDORES.
SOLICITAÇÃO DE TEF - PARCEIROS E REVENDEDORES
-
Parceiros e Revendedores devem realizar SOLICITAÇÕES DE TEF via abertura de ticket pelo chat com time de SUPORTE da ConnectPlug.
-
Para abrir um chamado, utilizando o Portal do Parceiro (https://parceiros.cplug.com.br/), acesse a opção SUPORTE>SOLICITAR SUPORTE> e abra um novo chat, como mostram os prints abaixo:
-
O SLA para estas solicitações é de 08 horas úteis.
Antes da abertura do chamado é IMPRESCINDÍVEL ter em mãos as seguintes informações para otimizar o atendimento:
-
-
Dados do cliente:
-
Razão Social
-
Nome Fantasia
-
CNPJ
-
-
Dados para contato:
-
Nome do responsável
-
Telefone do responsável
-
E-mail do responsável
-
-
Adquirente e Dados Lógicos:
-
De acordo com cada adquirente existe um padrão de Dados Lógicos que devem ser informados.
-
Consulte o artigo para visualizar as adquirentes homologadas e seus respectivos Dados Lógicos - ADQUIRENTES CREDENCIADAS
-
-
Adquirente
-
Dados lógicos
-
-
-
-
-
Com todas informações acima relacionadas, o PARCEIRO ou REVENDEDOR deverá abrir o chamado para SOLICITAÇÃO DE TEF via chat com TIME DE SUPORTE.
-
Este processo passa a valer a partir de 14/04/25 e a partir desta data emails enviados para nlogicos@cplug.com.br com solicitações de TEF oriundas de parceiros e revendedores não serão atendidas, será orientado a abrir chamado via time de Suporte.
Informações atualizadas em 11/04/2025
SOLICITAÇÃO DE PIX - PARCEIROS E REVENDEDORES
-
Parceiros e Revendedores devem realizar SOLICITAÇÕES DE PIX via abertura de ticket pelo chat com time de SUPORTE da ConnectPlug.
-
Para abrir um chamado, utilizando o Portal do Parceiro (https://parceiros.cplug.com.br/), acesse a opção SUPORTE>SOLICITAR SUPORTE> e abra um novo chat, como mostram os prints abaixo:
-
O SLA para estas solicitações é de 08 horas úteis.
Antes da abertura do chamado é IMPRESCINDÍVEL ter em mãos as seguintes informações para otimizar o atendimento:
-
-
Confirmação que cliente já possui TEF credenciada
-
Dados do cliente:
-
Razão Social
-
Nome Fantasia
-
CNPJ
-
-
Banco e Credenciais
-
De acordo com cada banco existe um padrão de credenciais que devem ser informadas.
-
Consulte o artigo para visualizar os bancos homologados e suas respectivas credenciais - Bancos Homologados
-
-
Banco
-
Credenciais
-
Tipo da Chave
-
Chave PIX
-
-
-
-
-
Com todas informações acima relacionadas, o PARCEIRO ou REVENDEDOR deverá abrir o chamado para SOLICITAÇÃO DE PIX via chat com TIME DE SUPORTE.
-
Este processo passa a valer a partir de 14/04/25 e a partir desta data emails enviados para nlogicos@cplug.com.br com solicitações de PIX oriundas de parceiros e revendedores não serão atendidas, será orientado a abrir chamado via time de Suporte.
Informações atualizadas em 11/04/2025
INSTALAÇÃO TEF
INSTALAÇÃO TEF
INSTALAÇÃO TEF - PDV 2.0
Módulo pago? Sim
Objetivo deste artigo será tratar do processo de instalação do módulo TEF na solução PDV2. Será descrito em detalhes o procedimento de instalação e dicas de boas práticas para as instalações.
Particularidades sobre os tipos de TEF no PDV 2.0:
Atualmente, oferecemos a flexibilidade de realizar transações através do TEF no PDV 2.0, seja utilizando um pinpad convencional (burro) em conjunto com uma adquirente ou optando pelo SMART TEF na máquina da Vindi.
Recentemente, introduzimos uma inovação que permite aos usuários realizar ambas as operações no mesmo terminal PDV 2.0. Isso significa que, se um cliente já utiliza TEF via pinpad com uma adquirente específica, ele pode continuar a realizar transações com ela. No entanto, agora também tem a opção de utilizar o SMART TEF como um terminal adicional para transações TEF em conjunto com a adquirente Vindi.
Anteriormente, no contexto do SMART TEF no PDV 2.0, existia uma limitação que restringia a utilização de dois contratos de cartões no mesmo terminal PDV 2.0. Com nossa mais recente atualização, superamos essa restrição, possibilitando agora a associação de dois contratos de cartões a adquirentes distintas.
Por exemplo: agora é possível associar o Contrato de Cartões da Rede para transações via TEF e o Contrato de Cartões da Vindi para transações utilizando o SMART TEF.
Essa inovação oferece ao operador de caixa a flexibilidade de escolher qual contrato de cartões deseja utilizar ao realizar uma venda, proporcionando maior praticidade e adaptabilidade às preferências da loja.
Para usufruir dessa funcionalidade, é necessário, após a conclusão bem-sucedida da instalação do TEF e do SMART TEF, acessar a área administrativa do PDV. Na seção de Operações TEF, deve-se vincular o contrato de cartões ao tipo de transação TEF desejado.
Atualmente, não dispomos de um provedor denominado Vindi integrado ao ERP para estabelecer a vinculação com o contrato de cartões da Vindi, que será utilizado em conjunto com o SmartTef. Entretanto, queremos assegurar que nossa equipe de produtos está empenhada em implementar essa funcionalidade o mais brevemente possível.
Para obter informações adicionais sobre o SMART TEF, recomendamos a leitura do seguinte artigo -> [SMART TEF]
1. Pré-Requisitos:
-
-
Módulo TEF disponível e em quantidade suficiente no plano do respectivo cliente
-
Atualizar PDV e CPSERVER para última versão disponível
-
2. Configuração ERP:
Caminho da tela abaixo: ERP>Ponto de Venda>Aplicativos>PDV>Configurações da SITEF>
-
Sessão - Configurações da SITEF:
-
Com exceção do IP DO SERVIDOR que será sempre 127.0.0.1, valide as demais informações e se necessário realize a edição de algum dado divergente via INSPECIONAR.
-
O campo ID, se refere ao IDSITEF, importante validar corretamente o número (gerado por NLOGICOS) lembrando que deve conter obrigatoriamente 08 dígitos.
-
-
Sessão - Configurações da VPN:
-
No cenário de uma instalação nova, selecione as opções SELECIONAR UM TERMINAL/CADASTRAR TERMINAL
-
Para coletar o número da OTP, acesse INSPECIONAR, clicando com botão direito do mouse em cima de TERMINAL (VPN) e colete o número da OTP, um exemplo da linha que consta o número de OTP do exemplo 3214137522
<input type="hidden" id="sitef_otp" name-"settting{sitef}{otp}" value="3214137522"
-
- No print abaixo será destacado os passos em INSPECIONAR:
3. Instalação PDV:
Caminho da tela abaixo: ERP>Ponto de Venda>Aplicativos>PDV>Configurações da SITEF>
Após a configuração no ERP, realize a sincronização de CPSERVER e PDV, ao acessar OPERAÇÕES TEF - INSTALAÇÃO, algumas informações já serão preenchidas, será importante validar as respetivas informações e completar dados restantes, abaixo descrição de cada campo:
-
-
-
CPF/CNPJ: Validar/Corrigir CNPJ ou CPF do respectivo cliente
-
Ponto de Captura: Será a identificação do TERMINAL para as transações no portal SITEF, facilitando e padronizando a identificação de cada terminal com a obrigatoriedade de 08 dígitos, por exemplo: Terminal 01, terá o ponto de captura: 00000001, terminal 02, terá o ponto de captura: 0000002
-
ID da Empresa: Validar/Corrigir o IDSITEF coletado anteriormente, com obrigatoriamente 08 dígitos
-
Servidor: Será utilizado por padrão: 127.0.0.1
-
Porta: Padronizado a porta 4096
-
Porta USB: Não há necessidade de especificar esta informação
-
-
-
Após validar todos campos, clique INSTALAR. Neste momento serão realizadas em segundo plano, as seguintes instalações:
-
-
Instalação de OTP no TERMINAL
-
Instalação e Ativação do SERVIÇO GSURF LISTNER
-
-
4. Validações e boas práticas:
-
Após instalação no terminal, valide CONTRATO DE CARTÕES E MÉTODOS DE PAGAMENTOS, se necessário realiza nova SINCRONIZAÇÃO DE CPSERVER E PDV.
-
Realize transação de teste
-
Se houver erros na transação, valide os seguintes pontos:
-
-
Certificar que haja número suficiente de TEF no respectivo plano
-
Instalar/atualizar drive do PINPAD em questão
-
Instalar Serial Device Manager para testar comunicação com pinpad, no caso de GERTEC, e descartar possibilidade de falha de comunicação
-
Validar ID SITEF+CNPJ no ERP
-
Validar/Recriar OTP via INSPECIONAR no ERP
-
Checar requisitos para verificar se não tem firewall impactando comunicação ou porta 4096 sendo utilizada - Utilize este link para baixar os REQUISITOS!
-
Reinstalar CERTIFICADO/OTP no terminal - Utilize este link para baixar o Instalador!
-
Reinstalar GSURF CLIENT LISTENER - Utilizando este link! - Certificar de inserir sitef em minúsculo em nome de serviço
-
Forçar a inicialização do serviço GSURF LISTENER
-
Renomear documento CLISITEF e remover ".example"
-
-
-
Se após a validação acima, seguir com erro, colete todas informações relacionadas e acione seu líder de squad e/ou time CX em slack.
INSTALAÇÃO TEF - TOTEM DE AUTOATENDIMENTO
Módulo pago? Sim
Objetivo deste artigo será tratar do processo de instalação do módulo TEF na solução TOTEM DE AUTOATENDIMENTO. A instalação de TEF no TOTEM é um processo muito mais simples do que a instalação de TEF no PDV, é necessário apenas validar as configurações no ERP e sincronizar o CPTOTEM, a seguir será descrito em detalhes o procedimento de instalação e dicas de boas práticas para as instalações.
1. Pré-Requisitos:
Antes de iniciar a instalação é preciso se certificar dos seguintes pontos:
-
-
Módulo TEF disponível e em quantidade suficiente no plano do respectivo cliente
-
Atualizar CPTOTEM para última versão disponível
-
2. Configuração ERP:
Caminho da tela abaixo: ERP>Ponto de Venda>Aplicativos>Totem>Configurações da SITEF>
-
Sessão - Configurações da SITEF:
-
Com exceção do IP DO SERVIDOR que será sempre 127.0.0.1, valide as demais informações e se necessário realize a edição de algum dado divergente via INSPECIONAR.
-
O campo ID, se refere ao IDSITEF, importante validar corretamente o número (gerado por NLOGICOS ou coletado via email: consulta.nlogicos@gmail.com ou via planilha de consulta) lembrando que deve conter obrigatoriamente 08 dígitos.
-
3. Validações e boas práticas:
-
Certifique-se que o CPTOTEM esta na última versão disponível na Play Store
-
Realize uma sincronização total e certifique-se que a mesma foi finalizada com sucesso
-
Valide CONTRATO DE CARTÕES E MÉTODOS DE PAGAMENTOS em APLICATIVOS>TOTEM>MÉTODOS DE PAGAMENTO, se necessário realiza nova SINCRONIZAÇÃO COMPLETA
-
Realize uma transação de teste
-
Se houver erros na transação, valide os seguintes pontos:
-
-
Certificar que haja número suficiente de TEF no respectivo plano
-
Valide que o PinPad seja um modelo homologado e esteja conectado
-
Validar ID SITEF+CNPJ no ERP
-
Se houver erro de Comunicação com SITEF, verifique nos LOGS do TOTEM se houve a instalação do CERTIFICADO, se negativa a instalação, pode haver bloqueio na rede ou modem do respectivo cliente, neste cenário devemos orientar o cliente a verificar estes bloqueios
-
-
-
Se após a validação acima, seguir com erro, colete todas informações relacionadas e acione seu líder de squad e/ou time CX em slack.
TRATATIVA DE ERROS
TRATATIVA DE ERROS
GSURF - DICAS E TRATATIVAS
Existem cenários com restrições de permissões (firewall e/ou políticas de usuários com restrições de acesso) que podem resultar em erros durante o processo de instalação e/ou utilização do módulo TEF/PIX.
Objetivo deste artigo é fornecer base para algumas tratativas destes cenários e fornecer dados para acionamento de suporte do time GSURF.
1. Boas práticas:
O cenário ideal para utilização do GSURF LISTNER - Serviço de VPN necessário para utilização do módulo de TEF deverá ser validado com as boas práticas descritas abaixo:
-
Verificação de Requisitos sem apresentação de erros
-
Perfil Administrador do Sistema Operacional (não de nosso ERP)
-
Firewalls desabilitados
2. Cenários de erros:
-
-
Execução do VERIFICADOR DE REQUISITOS - GSURF - Veja o print abaixo:
-
-
-
No print acima são exibidos o status OK em verde, se forem apresentados erros em vermelho parecidos com os alistados abaixo:
-
-
-
Erros relacionados a coleta FINGERPRINT
-
Erros de comunicação relacionados a DNS / CDP / UDP / TCP
-
Erros relacionados a comunicação com GSURF
-
-
-
-
Políticas de segurança e restrições de firewall: Se nosso cliente possuir politicas de segurança de usuários e/ou restrições de firewall, isso pode ocasionar erros de comunicação com SITEF e/ou GSURF
-
3. Verificações relacionadas a permissão de acesso GSURF
-
Permissão total de gravação e leitura da pasta CLISITEF
-
Porta TCP 4096 liberada e não sendo utilizada por outro sistema de VPN:
-
-
Para validar a liberação da porta acima, utilize o aplicativo TCP VIEW - Clique aqui para realizar o download!
-
-
-
Print acima demonstra a utilização do TCP VIEW:
-
No campo de pesquise, insira a porta 4096, o cenário ideal é que nenhum aplicativo e/ou serviço esteja utilizando esta porta, o resultado da pesquisa não pode retornar nenhum resultado
-
-
Se nosso cliente possuir POLÍTICAS DE SEGURANÇA o time de TI de nosso cliente deverá validar as seguintes liberações:
-
-
Endereço IP e Máscara de Sub-rede:
-
Endereço IP: 18.231.194.64
-
Máscara de sub-rede: /26 (Isso significa que o intervalo de IPs vai de 18.231.194.64 a 18.231.194.127)
-
-
Portas de Liberação TCP:
-
-
4096
-
443
-
55844
-
55845
-
-
-
Portas de Liberação UDP:
-
-
18.231.194/26 443
-
DNS Local 53 UDP (consultas em gsurfnet.com)
-
-
-
Permissões de Usuário Instalação:
-
-
Usuário que realiza a instalação do GSURF LISTNER e instalação da TEF no terminal precisa ser de perfil ADMINISTRADOR (do sistema operacional e não de nosso ERP)
-
-
-
Permissões de Usuário OPERADOR PDV:
-
-
Usuário com permissão de validação FINGERPRINT
-
-
-
Serviço GSURF LISTNER utiliza metodologia TLS
-
-
4. Acionamento time GSURF
-
As verificações e orientações ao cliente acima, devem ser realizadas nos cenários de erro pelo analista que realiza a instalação do módulo de TEF.
-
Em alguns cenários de erro de comunicação com SITEF, o time de SUPORTE SITEF pode sinalizar a necessidade de verificações adicionais pelo time de SUPORTE GSURF, neste caso o analista deverá acionar o time GSURF pelos contatos abaixo:
-
-
Time SUPORTE GSURF: Telefones: (48) 3254-8700 / (48) 3181-0033
-
-
COLETA DE EVIDÊNCIAS
No cenário de erros de transações, após validação do time de PPI, pode ser necessário abertura de chamado junto a SITEF ou outras tratativas internas.
Quando houver esta necessidade, será obrigatório a abertura de ticket relacionado ao respectivo caso, alistamos abaixo informações obrigatórias que devem constar neste chamado:
-
Dados do Cliente:
-
-
SCHEMA
-
CNPJ
-
Razão Social
-
Equipamentos utilizados:
-
-
Modelo do PINPAD
-
-
-
Versão do PDV/TOTEM
-
-
-
Identificação da Adquirente:
-
Tipo da Transação:
-
-
Inserção
-
Aproximação Cartão
-
Bandeira do Cartão
-
Aproximação Smartphone: Atenção aos dados abaixo:
-
-
Modelo Iphone ou Android
-
-
-
-
-
Qual aplicativo utilizado:
-
-
ApplePay
-
GooglePay
-
AndroidPay
-
-
-
Qual Banco utilizado?
-
04 primeiros números do cartão que foi utilizado na transação:
-
Estes números (também identificados com BIN) são obrigatórios para que a FISERV possa ter acesso detalhado a transação.
-
-
É realizado debito e estorno de maneira automática no respectivo banco ou cartão do cliente final?
-
Dados da Transação:
-
-
Data e Hora da transação
-
Valor da Transação
-
Se cliente utilizar mais de um PDV/TOTEM, qual PDV/TOTEM origem da transação
-
-
-
Evidências do Erro
-
-
Vídeo do erro, mostrando tentativa e erro
-
DMP do respectivo PDV/TOTEM - Arquivo dentro da pasta CLISITEF
-
Se totem enviar LOG
-
-
RETORNO DE ERRO: DADOS LÓGICOS - SOLICITAÇÕES TEF
O retorno de dados lógicos inválidos pode se dar pelas seguintes razões:
-
Erro de digitação nos dados lógicos
-
Dados lógicos não vinculados ao CNPJ do cliente em questão
-
Dados lógicos expirados ou ainda não validados pela adquirente
Tratativas de solução:
-
Compartilhar com cliente o print enviado no retorno de erro
-
Orientar o cliente a acionar a adquirente e solicitar novos dados lógicos ou a confirmação da liberação dos mesmos dados lógicos, para o respectivo CNPJ: ATENÇÃO PARA CENÁRIO MULTI-EMPRESA é comum haver divergência entre dados lógicos e CNPJs das filiais.
-
Obrigatório coletar a evidencia desta tratativa entre cliente e adquirente: um PRINT que conste os dados do cliente (CNPJ e Razão Social) e dados lógicos informados pela adquirente. O print se faz necessário para eliminar a possibilidade de erros de digitação.
-
Responda no ticket em questão as informações acima, principalmente com o PRINT como evidência.
-
Observação importante: Nenhum analista da CPLUG tem autonomia para acionar uma adquirente e validar dados lógicos de qualquer cliente. Tratam-se de dados sensíveis e de responsabilidade total entre cliente e adquirente.
RETORNO DE ERRO: FALHA NAS CREDENCIAIS - SOLICITAÇÕES PIX
O retorno de falha nas credenciais pode se dar pelas seguintes razões:
-
Falta de vínculo com respectivo Bankline ou portal do respectivo banco:
-
Cenários onde existe mais de uma chave pix cadastrada, alguns bancos exigem vínculo com a chave pix correta
-
-
Erro de digitação das credenciais:
-
Em casos de credenciais com CLIENT ID e CLIENT SECRET a possibilidade de erro de digitação é grande
-
Tratativas de solução:
-
Compartilhar com cliente o print enviado no retorno de erro
-
Validar com cliente processo de vínculo com Bankline ou portal do respectivo banco. Utilize os artigos desta seção para consulta - Clique aqui!
-
Obrigatório coletar a evidencia do vínculo com Bankline ou portal do respectivo banco: um PRINT que conste as respectivas credenciais. O print se faz necessário para eliminar a possibilidade de erros de digitação.
-
Orientar o cliente a acionar o banco e solicitar novas credenciais ou a confirmação da liberação das mesmas credenciais.
-
Obrigatório coletar a evidencia desta tratativa entre cliente e banco: um PRINT que conste os dados do cliente (CNPJ e Razão Social) e credenciais informadas pelo banco. O print se faz necessário para eliminar a possibilidade de erros de digitação.
-
Responda o ticket com as informações acima, principalmente com o PRINT como evidência.
-
Observação importante: Nenhum analista da CPLUG tem autonomia para acionar um banco e validar credenciais de qualquer cliente. Tratam-se de dados sensíveis e de responsabilidade total entre cliente e banco.
RETORNO DE ERRO: CNPJ EXISTENTE NA FISERV - SOLICITAÇÕES TEF
Informações importantes sobre o erro de CNPJ EXISTENTE NA FISERV:
-
Cenário onde o respectivo cliente já utilizava outra Software House ou Integradora de TEF pela FISERV (utilizando SITEF EXPRESS, SkyTef ou outra integradora que utilize a base ou serviços vinculados a FISERV)
-
O credenciamento na base de dados da CPLUG via SITEF EXPRESS de um cliente no perfil acima só é possivel se forem atendidas uma das alternativas abaixo:
-
Exclusão completa do cadastro: Opção mais indicada e de menor complexidade
-
Duplicação de CNPJ feita pelo time FISERV: Importante destacar que a duplicação a solicitação junto a FISERV, deve ser feita entre CPLUG e FISERV. Veja detalhes abaixo, de como o cliente deve solicitar isso para CPLUG.
-
Tratativas de solução:
1. Exclusão completa de cadastro:
1.1 Antiga Software House ou Integradora precisa EXCLUIR COMPLETAMENTE cadastro na FISERV/SITEF EXPRESS/SKYTEF, após exclusão é necessário reiniciar módulo GERPDV no respectivo ambiente FISERV/SITEF EXPRESS/SKYTEF.
1.2 Evidência que formalize e confirme a exclusão: um print de um email que conste dados do cliente (CNPJ e Razão Social, Dados da antiga Software House ou Integradora e confirme a EXCLUSÃO do cadastro e reset do módulo GERPDV.
1.3 Obrigatório que o analista envie um print deste email em resposta ao retorno de erro.
1.4 SLA desta solicitação dependerá de atuação time Nlógicos e time FISERV: não deve ser informado o prazo de 24 horas úteis, o time NLOGICOS retornará assim que finalizada a ocorrência.
2. Duplicação de Cadastro na FISERV:
2.1 Caso a antiga Software House ou Integradora não forneça a evidência acima ou dificulte o processo: O cliente deve enviar para o analista que esta tratando a solicitação) no seguinte padrão:
-
-
-
Titulo do email: Solicitação de Migração de Parceiro - FISERV
-
Corpo do email:
-
-
Dados da Empresa: CNPJ e Razão social
-
Formalizo o interesse de migrar de parceiro, passarei a utilizar a CONNECT PLUG como integradora na FISERV e desejo que meu cadastro seja duplicado no ambiente FISERV, para que a ConnectPlug possa me credenciar como seu cliente, em sua base de dados na FISERV.
-
-
-
2.2 Obrigatório que o analista envie um print deste email em resposta ao retorno de erro, no respectivo ticket,
-
2.3 SLA desta solicitação dependerá de atuação time Nlógicos e time FISERV: não deve ser informado o prazo de 24 horas úteis, o time NLOGICOS retornará assim que finalizada a ocorrência.
-
-
INSTALAÇÃO PIX
INSTALAÇÃO PIX
INSTALAÇÃO PIX - PDV E TOTEM DE AUTOATENDIMENTO
Objetivo deste artigo será tratar do processo de instalação do módulo PIX NA TEF em ambos aplicativos: PDV 2 e TOTEM DE AUTOATENDIMENTO.
1. Pré-Requisitos:
Antes de iniciar a instalação é preciso se certificar dos seguintes pontos:
-
-
Credenciamento e Instalação TEF finalizados com sucesso
-
Atualizar PDV e CPSERVER para última versão disponível
-
2. Configuração ERP para PDV 2:
Caminho da tela abaixo: ERP>Financeiro>Métodos de Pagamento
-
Habilite o método de pagamento PIX para respectivo PDV
Caminho da tela abaixo: ERP>Financeiro>Contrato de Cartões>
-
Crie um Contrato de Cartões identificado como PIX
-
Especifique o PROVEDOR PIX
3. Configuração ERP para TOTEM DE AUTOATENDIMENTO:
Caminho da tela abaixo: ERP>Pontos de Vendas>Aplicativos
-
No respectivo totem, clique no ícone relacionado a método de pagamento
-
Clique em Disponibilizar Método de Pagamento
-
Inclua o método PIX e clique em Salvar
Caminho da tela abaixo: ERP>Financeiro>Contrato de Cartões>
-
Crie um Contrato de Cartões identificado como PIX
-
Especifique o PROVEDOR PIX
4. Sincronização e Utilização:
-
-
Feito as configurações anteriores é OBRIGATÓRIO A SINCRONIZAÇÃO nos respectivos terminais (PDV 2 ou TOTEM DE AUTOATENDIMENTO)
-
Após sincronização realize uma transação de teste, e valide a exibição do QR CODE:
-
No cenário WINDOWS o QRCODE poderá ser exibido na tela do PDV ou no PINPAD (recursos sujeito a disponibilidade pelo PINPAD)
-
No cenário TOTEM DE AUTOATENDIMENTO com PINPAD MP15, será exibido na tela do TOTEM DE AUTOATENDIMENTO
-
No cenário TOTEM DE AUTOATENDIMENTO com outros PINPADS o QRCODE será exibido na tela do TOTEM ou no PINPAD (recursos sujeito a disponibilidade pelo PINPAD)
-
-
PIX POR APROXIMAÇÃO
?️ Podcast: Escute para aprender
?️ Vídeo: Assista para entender
A funcionalidade PIX por Aproximação foi desenvolvida pela nossa TEF House, a Fiserv (Sitef), e permite que o cliente final realize pagamentos via PIX por meio da aproximação de seu smartphone (NFC).
Impacto para o Cliente e a Operação:
- Agilidade e Praticidade: O pagamento por aproximação, efetuado diretamente no PinPad, proporciona maior agilidade e praticidade no checkout.
- Segurança: A nova modalidade complementa o método tradicional (QR Code), oferecendo mais velocidade e segurança para as operações.
- Diferencial ConnectPlug (Comercial): O time Comercial deve destacar que a solução PIX da ConnectPlug agora oferece duas possibilidades: via QR Code e via aproximação.
✅ Pré-Requisitos
Para que o cliente possa usufruir do PIX por Aproximação, os seguintes pontos devem ser confirmados pelo time de Implantação e Suporte:
- Credenciamento PIX: O ambiente PIX do cliente deve estar previamente configurado e homologado na Fiserv/Sitef Express.
- Versão do PDV: É obrigatório que o PDV esteja utilizando a versão 2.11.13 ou superior. Esta versão inclui a atualização necessária do CLISITEF, homologada pelo time de Produtos da ConnectPlug.
- PinPad Homologado: O cliente deve utilizar um PinPad homologado. O modelo PPC 930 é o recomendado pela ConnectPlug.
Carteiras Digitais (Cliente Final): Para a aproximação funcionar, o cliente final deve utilizar uma carteira digital homologada pela Fiserv. Atualmente, as únicas carteiras homologadas para PIX por aproximação via Sitef são Samsung Pay e Google Pay.
⚙️ Passo a Passo (Habilitação e Utilização)
A configuração básica do PIX (Contrato de Cartões, Provedor PIX) é um pré-requisito. O procedimento a seguir foca na validação técnica (Implantação/Suporte) e na utilização no PDV..
-
Verificação da Versão do PDV e Componentes:
- Verifique se o cliente possui o PDV na versão 2.11.13 ou superior.
- Confirme se a instalação do TEF/PIX foi finalizada com sucesso, incluindo a correta instalação do PinPad homologado (ex: PPC 930).
-
Interação no PinPad (Aproximação):
- Ao selecionar PIX, o PinPad (ou a tela do PDV, dependendo do cenário de exibição do QR Code) será aberto para a transação.
- O PinPad exibirá a possibilidade de aproximação.
-
Finalização da Transação por Aproximação (NFC):
- O cliente final deve abrir uma carteira digital homologada (Samsung Pay ou Google Pay).
- A transação será efetuada por aproximação via NFC do smartphone ao PinPad.
Preparação no PDV (Operação de Venda): O operador de caixa deve iniciar a venda normalmente e selecionar a modalidade de pagamento PIX no fechamento.
❓ Dúvidas Frequentes
-
A aproximação substitui o QR Code? Não. A funcionalidade não substitui o QR Code, mas sim adiciona uma segunda possibilidade de pagamento PIX: via QR Code ou via aproximação. O QR Code continua sendo exibido.
-
Por que a lista de carteiras digitais suportadas é limitada? A limitação atual de suportar apenas Google Pay e Samsung Pay é uma restrição determinada pela Fiserv/Sitef. Esta não é uma limitação da ConnectPlug. Outras carteiras digitais, por enquanto, não foram homologadas pela Fiserv.
-
O que devo fazer se o cliente tiver um erro na transação por aproximação? Em cenários de erro de transação, se as validações de versão do PDV e PinPad homologado estiverem corretas, o analista deve seguir o procedimento de Coleta de Evidências. É crucial coletar informações detalhadas, como se a aproximação foi feita com Cartão ou Smartphone, qual aplicativo foi utilizado (ApplePay, GooglePay, AndroidPay), qual banco e outras informações que forem relevantes.
Integrações com POS
Integrações com POS
SumUp
A partir da versão 2.11.2 de nosso PDV 2 na versão Windows, será possivel utilizar a POS SumUp Solo para realização de pagamentos, não se trata do modelo convencional de POS, sua utilização será utilizado exclusivamente como dispositivo de recebimento de transações apenas, não sendo utilizado como terminal de PDV ANDROID e TOTEM DE AUTOATENDIMENTO.
A integração não ocorrerá por meio da FISERV nem por meio do módulo SmartTef, não havendo necessidades de solicitação de credenciamento TEF ou de processos de liberação junto a SumUp.
As únicas obrigatoriedades são:
-
Uma conta ativa na SumUp e os módulos de TEF e Contrato de Contrato de Cartões ativos no respectivo plano.
1. Passo a Passo para Integração:
Caminho da tela abaixo: ERP>Financeiro>Contrato de Cartões>Nova Configuração
-
Criar uma nova Configuração de Contrato de Cartões com titulo: SumUp, atribuir o provedor: SumUp, habilitar pelo menos uma opção de pagamento
Caminho da tela abaixo: Portal SumUp Minha Conta/Permissão de acesso
-
Ao salvar a nova Configuração, será direcionado ao Portal Minha Conta - SumUp, nosso cliente deverá se logar em sua respectiva conta SumUp
-
Ne tela de permissão de acesso ao Perfil SumUp, deverá clicar em Permitir.
Caminho da tela abaixo: ERP>Financeiro>Contrato de Cartões>
-
Após isso, será novamente direcionado a Configuração de Contrato de Cartões em nosso ERP com o respectivo contrato de cartões ativo, para validar se a integração está ativa, valide se na frente do Provedor de Contrato de Cartões consta a SumUp e o botão X (este botão será utilizado para excluir ou desativar a integração)
2. Pareamento com PDV 2:
Caminho da tela abaixo: PDV 2>Área Administrativa>Operações TEF>SumUp
-
Identifique o dispositivo com um título de sua preferência, insira o Código de Pareamento ou Código de Ativação
-
-
Passo a Passo para adquirir Código de Pareamento:
-
-
-
Acesse o Portal Minha Conta - SumUp;
-
Na parte superior direita da tela, clique em cima do seu nome;
-
Depois, selecione “Minhas máquinas”, aqui que você encontrará seu código de ativação!
-
-
-
-
-
-
A partir deste momento a POS SumUp Solo estará pronta para uso, no momento de se finalizar uma venda, ao se selecionar o Contrato de Cartões SumUp a transação será direcionada para POS, dando a opção de se inserir ou aproximar cartões ou smartphones via aproximação.
Dúvidas comuns:
1. É possivel utilizar uma única POS para mais de um PDV 2?
Não, cada PDV deverá ter uma única POS vinculada
2. É possivel utilizar a POS SumUp juntamente com outro contrato de TEF, outra adquirente ou SmartTef?
Não em um mesmo PDV, se houverem outros PDVs em cada PDV poderá ser vinculado uma opção de pagamento TEF