Integração com o host - Plain TCP (socket tunnel)

  1. Entendendo a comunicação
  2. Exemplo de utilização
  3. Configuração do dispositivo
  4. Compilação da aplicação
  5. Configuração do CloudWalk Manager
  6. Testando a comunicação

Entendendo a comunicação

Uma das formas de se estabelecer uma comunicação entre o serviço CloudWalk e um host autorizador é através do protocolo TCP/IP. O diagrama abaixo representa uma comunicação entre o dispositivo, o serviço CloudWalk e o host autorizador:

CloudWalk

  1. O dispositivo executa o comando network.send;
  2. O switch transacional recebe o conteúdo enviado pelo dispositivo e o encaminha para o socket na url e porta configurada para o aplicativo no CloudWalk Manager;
  3. A resposta do socket é retornada para o switch transacional;
  4. O dispositivo executa o comando network.receive e recebe a resposta.

Atenção: Após efetuar um network.send e um network.receive, é necessário efetuar um network.hosdisconnect para que seja possível realizar uma nova chamada (send).

Exemplo de utilização

Para fins de teste, disponibilizamos um host autorizador pronto para ser utilizado. O autorizador é extremamente simples, utilizado exclusivamente para fins de testes.

Pré-requisitos

  1. Conta no CloudWalk Manager: Crie uma gratuitamente em https://manager.cloudwalk.io
  2. CloudWalk Framework: Dispositivo devidamente instalado e configurado
  3. Acesso à internet: É necessário que o dispositivo tenha acesso a internet (Ethernet, Dial ou GPRS)

Configuração do dispositivo

Este guia assume que o seu dispositivo já possui o CloudWalk Framework devidamente instalado e configurado, e que o número de série do dispositivo já está cadastrado no CloudWalk Manager.

Caso não tenha certeza dos passos acima, confira a seção CloudWalk Framework - Configuração do dispositivo

Compilação da aplicação

  1. Acesse sua conta no CloudWalk Manager
  2. Selecione a primeira opção: Aplicações
  3. Clique no botão Nova aplicação
  4. Preencha o nome da aplicação, por exemplo: tcpapp
  5. Preencha a descrição da aplicação, por exemplo: Teste com TCP IP
  6. Preencha o autorizador com a URL tcp://tcp-echo.cloudwalk.io:8000
  7. Marque Sim na opção 'Aplicação deve ser exibida no menu de serviços?'
  8. Preencha TCP IP no nome de exibição no POS
  9. Clique no botão Cadastrar aplicação
  10. Deverá ser exibida uma mensagem indicando que a aplicação foi devidamente cadastrada

Configuração do CloudWalk Manager

O último passo consiste em configurar o CloudWalk Manager. Siga o seguinte procedimento:

Cadastre um grupo

  1. Selecione a opção: Grupos
  2. Clique no botão Novo grupo
  3. Preencha o nome do grupo, por exemplo: GRUPO TESTE
  4. Clique no botão Cadastrar grupo
  5. Clique então no botão Atualizar grupo
  6. Selecione a aplicação previamente cadastrada, clicando no checkbox
  7. Clique no botão Atualizar aplicações do grupo

Cadastre o número lógico

Todo dispositivo deve possuir um número lógico, que é a identificação do dispositivo no CloudWalk. Para configurar o número lógico, siga o seguinte procedimento:

  1. Selecione a opção: Números lógicos
  2. Clique no botão Novo número lógico
  3. Informe o número lógico, por exemplo 0001
  4. Marque o grupo criado anteriormente (GRUPO TESTE) e clique no botão Cadastrar número lógico

Associar o número lógico

O próximo passo é associar o dispositivo com o número lógico recém criado, pressionando a tecla F1 (Verifone) ou F (Telium). A seguinte tela será apresentada:

CONFIGURATION MENU

1 CLOUDWALK
2 DEVICE SETTINGS
3 MASTER / VISA
4 ABOUT
5 QUIT

Selecione então a opção 1 LOGICAL NUMBER e informe o número lógico recém cadastrado (0001):

CLOUDWALK SETTINGS

1 LOGICAL NUMBERS
2 DELETE APPS
3 REINSTALL
4 BACK

translation missing: pt-BR.integration.http.walk_manager_setup.associate_logical_number.paragraph_3

LOGICAL NUMBER

: 0001

After entering the logical number, press enter (green).

Testando a comunicação

Com o dispositivo preparado, a aplicação compilada e tudo configurado no CloudWalk Manager, chegou a hora de testar a comunicação entre todos os componentes envolvidos: dispositivo, CloudWalk e o host autorizador.

1. Download da aplicação

Pressione a tecla verde e será realizado o download da aplicação previamente configurada no CloudWalk Manager:

  DOWNLOADING ...

Ao finalizar o processo, a seguinte mensagem será exibida:

  DOWNLOAD COMPLETE!


     PRESS GREEN

2. Execução da aplicação

Após baixar a aplicação e pressionar o botão verde, a aplicação será automaticamente executada.

TCP socket test
Connecting ...
TCP socket test
Connected!
TCP socket test
Connected!

Sending ...
TCP socket test
Connected!

Sending ...

Socket response:
CLOUDWALK 0123456789

Se falhar

Verificar configuração de comunicacão do dispositivo, montagem dos cabos e conexão com a internet.

TCP socket test
Connection failed!

Testando sua requisição

Existem várias ferramentas e serviços que podem lhe auxiliar a testar o retorno de suas requisições. Um exemplo é o próprio telnet, que oferece uma interface bem simples, conforme pode ser observado abaixo:

telnet