Olá, como podemos ajudar você?

  1. Página inicial
  2. Voltar para a pesquisa
Integração TEF SCOPE
9 min
Criado por Omar Mohamad Abou Arabi em 02/09/2026 19:42
Atualizado por Omar Mohamad Abou Arabi em 02/09/2026 20:59

Integração TEF SCOPE

Cadastro, Configuração e Download das DLLs

Objetivo

Orientar a equipe técnica na integração do TEF SCOPE: cadastro da empresa, loja, terminais, token e contrato no portal Scope, além do download das DLLs necessárias e da configuração do arquivo scope.ini e da estação no PDV.

Cadastro da Empresa

Realizar o cadastro da empresa no portal Scope (scope-portal-integradores.conexao-tech.com):

  1. Acessar o portal e, no menu, selecionar Empresa > Cadastrar Empresa.

  2. No formulário exibido, definir Parceiro: Desbravador.

  3. Informar o Nome da empresa.

  4. O campo Assinatura PDV é preenchido automaticamente pelo sistema — não é necessário informar.

  5. Informar Licenças Totais com a quantidade contratada pelo cliente.

  6. As informações de conta corrente não são obrigatórias e podem ficar em branco.


Caminho: Portal Scope | Empresa > Cadastrar Empresa


Cadastro da Loja

Após o cadastro da empresa, realizar o cadastro da loja:

  1. Na listagem de Gerenciamento de empresa, localizar a empresa cadastrada.

  2. Clicar no ícone de Loja, na coluna Ações, para abrir o cadastro de loja vinculado a essa empresa.

Incluir as informações do cliente no formulário de Cadastro de loja:

  1. Preencher os dados da loja: Empresa (vinculada automaticamente), Código da loja, Nome fantasia e Razão social.

  2. Informar CPF/CNPJ e Inscrição estadual da loja.

  3. Informar o Telefone de contato.

  4. Marcar a opção PINPad ABECS 2.12 ou superior quando aplicável.

  5. Preencher os campos de Endereço da loja.

No exemplo, a loja foi cadastrada com o código 7147, no endereço de São Paulo, bairro Consolação.




                                                                                                           


Caminho: Portal Scope | Empresa > Gerenciamento de Empresa > Loja

Cadastro de Terminal e Token

Cadastro de Terminal

Após o cadastro da loja, cadastrar os terminais e o token.

  1. Na listagem de Gerenciamento de loja, clicar no ícone de Terminal para abrir o Cadastro de terminal (PDV).

  2. Marcar a opção Habilitado / Online.

  3. No campo Número Inicial, informar o número do cadastro do terminal que será configurado no PDV.

  4. Em Quantidade de terminais, informar 1.

  5. ⚠️ Em Perfil de Serviço, escolher o perfil de acordo com a adquirente. Esse perfil determina informações já cadastradas anteriormente e não pode ser alterado — ele define, por exemplo, se a venda poderá ser parcelada.

  6. Em Perfil Físico, definir a comunicação com o PIN Pad. Exemplo: deixando Perfil HW Default – ABECS – Auto, o sistema busca automaticamente a comunicação com o PIN Pad (orientação do Giarlo é manter esse perfil).



Caminho: Portal Scope | Loja > Gerenciamento de Loja > Terminal

Cadastro de Token

Na sequência, realizar o cadastro do Token do terminal.

  1. A validade da inclusão do token é de 24 horas.

  2. O token será responsável pelo registro da comunicação do PDV.

  3. Clicar em Obter para que o token seja gerado automaticamente.

Caminho: Portal Scope | Loja > Gerenciamento de Loja > Token

Cadastro de Contrato

Após finalizar o cadastro da empresa, loja, terminais e token, é necessário cadastrar o Contrato.

  1. No menu, acessar Contrato > Gerenciar Contrato.

  2. Utilizar o formulário de pesquisa para localizar o contrato a ser cadastrado.

Identificar o cliente e a adquirente, e incluir as informações necessárias no contrato:

  1. Na listagem de Gerenciamento de contrato, localizar o cliente e a adquirente correspondentes, como Banco do Brasil, CIELOPIX, DM, ITAU-UNIBANCO, CIELO, TELENET, DBR, ECXCARD, PAGBANK ou SAFRAPAY.

  2. No Cadastro de contrato, selecionar a Rede e a Versão de especificação.

  3. ⚠️ Informar o Estabelecimento e o Terminal da rede. Onde está escrito "Terminal da rede", leia-se "Número lógico".

  4. Marcar, quando aplicável, as opções Aceita Cartão Digitado? e Aceita mobile?.

  5. Na grade de Bandeiras, selecionar as bandeiras aceitas — ou usar Selecionar todas bandeiras.

  6. Processo de cadastro finalizado.


Caminho: Portal Scope | Contrato > Gerenciar Contrato

Download de Pacotes e DLLs do Scope Client

Acessar o Portal do Desenvolvedor

O local de download dos pacotes é o portal: conexao-tech.atlassian.net/servicedesk/customer/portals

  1. Acessar o Portal do Desenvolvedor.

Caminho: Portal Scope | conexao-tech.atlassian.net > Portal do Desenvolvedor

Localizar Pacotes e Bibliotecas

Dentro do Portal do Desenvolvedor, localizar os pacotes necessários para a integração.

  1. Encontrar o item Pacotes e Bibliotecas.

  2. Selecionar Scope Client.




Caminho: Portal Scope | Portal do Desenvolvedor > Pacotes e Bibliotecas > Scope Client

Escolher a Arquitetura

Na página do Scope Client, escolher a arquitetura do pacote a ser baixado.

  1. ⚠️ Escolher entre Arquitetura x86 ou Arquitetura x64. As DLLs utilizadas nesta integração serão as da arquitetura x86.

Caminho: Portal Scope | Portal do Desenvolvedor > Scope Client > Arquitetura x86/x64

Escolher a Pasta config

Dentro do pacote baixado, navegar pela estrutura de pastas disponível (config, develop, java, linux, win32).

  1. Escolher a pasta config.

Caminho: Portal Scope | Scope Client > config

Download das DLLs —win32/Release
Para o download das DLLs utilizadas na integração:

  1. Escolher a pasta win32.

  2. Dentro dela, acessar Release e baixar os arquivos DLL listados.

  3. ⚠️ As DLLs devem ser incluídas na mesma pasta do PDV (C:\DSL\FAST\).





Caminho: Portal Scope | Scope Client > win32 > Release

Configuração do scope.ini

Definir Empresa e Loja no scope.ini

A única configuração realizada no scope.ini é a seção [21477147], que define a Empresa e a Loja:

  1. No Scope, localizar o código da Empresa cadastrada — no exemplo, 2147.

  2. Localizar o código da Loja vinculada — no exemplo, 7147.

  3. A seção do scope.ini é nomeada com a junção dos dois códigos: [21477147].


Caminho: Portal Scope | scope.ini > [Empresa][Loja]

Parâmetros URL e EmpresaSign

Dentro da seção [21477147], informar os parâmetros URL e EmpresaSign:

  1. URL=https://scope-tef-integradores.conexao-tech.com — conexão padrão HTTPS.

  2. EmpresaSign define a assinatura do PDV; o valor é obtido no campo Assinatura PDV do Cadastro de empresa (no exemplo, 4a5d72540369630e6f2f01330f803aab).

Assim, a seção completa do scope.ini fica:

[21477147]

URL=https://scope-tef-integradores.conexao-tech.com

EmpresaSign=4a5d72540369630e6f2f01330f803aab



Caminho: Portal Scope | scope.ini > [21477147]

Configuração do TEF no PDV

Por fim, configurar a estação de Transferência Eletrônica de Fundos (TEF) no PDV:

  1. Em TEF, selecionar TEF - Scope.

  2. Em IP, informar o endereço do servidor (exemplo: es.conexao-tech.com).

  3. Em Empresa, informar o código cadastrado no Scope (exemplo: 2147).

  4. Em Loja/Filial, informar o código da loja (exemplo: 7147).

  5. Em Terminal/PDV, informar o número do terminal (exemplo: 001).

  6. Marcar Ambiente de produção quando for o caso.

  7. Utilizar o botão Testar PINPAD para validar a comunicação antes de avançar.


Caminho: Portal Scope | PDV > Configurando Estação > TEF - Scope








Este artigo foi útil para você?
Últimos artigos visitados