Perguntas frequentes sobre a CloudWalk

  1. Dispositivo
  2. Desenvolvimento
  3. Comunicação
  4. Contratos e serviços

Dispositivo

Como faço para configurar a comunicação de um dispositivo?

Existe um assistente interativo que irá guiá-lo através de todo o processo de configuração:

  1. Primeiramente, pressione o botão Função do dispositivo (F para Ingenico, F1 para Verifone);
  2. Digite a senha (a senha padrão é 55555);
  3. No menu de configuração, selecione a opção DEVICE SETTINGS;
  4. Em seguida, selecione a opção COMMUNICATION;
  5. Agora você pode escolher o tipo de comunicação e preencher as informações solicitadas.

Posso adicionar novos arquivos (imagens, texto, etc) a um dispositivo?

Sim. Este procedimento é realizado em quatro passos:

  1. Vá para a seção de gerenciamento de Arquivos e faça o upload dos arquivos;
  2. Vá para a seção de gerenciamento de Aplicações e edite a aplicação que irá utilizar estes arquivos;
  3. Selecione os arquivos na lista de Arquivos da aplicação e atualize a mesma;
  4. Agora, assumindo que o dispositivo está associado com a aplicação que você acabou de adicionar os arquivos, basta atualizar o dispositivo e os novos arquivos serão baixados.

Como faço para limpar um dispositivo?

  1. Primeiramente, pressione o botão Função do dispositivo (F para Ingenico, F1 para Verifone);
  2. Digite a senha (a senha padrão é 55555);
  3. No menu de configuração, selecione a opção CLOUDWALK;
  4. Em seguida, selecione a opção DELETE APPS;

Qual é o dispositivo mais adequado para minhas necessidades?

Isso depende do projeto, mas em geral, antes de comprar um dispositivo, certifique-se de que o mesmo cumpre os requisitos do projeto. Por exemplo, se a mobilidade é um fator importante, um dispositivo com GPRS deve ser adquirido. Também é necessário ter certeza de que o dispositivo é compatível com o serviço CloudWalk.

Quais dispositivos são compatíveis com o serviço CloudWalk?

Confira lista de dispositivos homologados.

É possível ter várias aplicações no mesmo dispositivo?

Sim, isso é perfeitamente possível, pois os dispositivos CloudWalk estão preparados para lidar com qualquer quantidade de aplicativos POSXML. Se um dispositivo for configurado para ter acesso a uma única aplicação, quando o botão verde é pressionado, essa aplicação é automaticamente iniciada. No entanto, se o dispositivo tem acesso a múltiplas aplicações, quando o botão verde é pressionado, um menu com a lista de todas as aplicações é exibida, para que você possa escolher uma delas para iniciar.

A seção de gerenciamento de Grupos define quais aplicações devem ser acessíveis em um determinado grupo. Depois de configurado, qualquer quantidade de números lógicos podem ser atribuídos a esse grupo, através da seção de gerenciamento de números lógicos.

Como faço para configurar uma integração simples entre um dispositivo e um host?

Confira o exemplo de integração HTTP.

Qual é a senha para acessar o menu de configuração?

A senha padrão é 55555.

É possível alterar a senha padrão do menu de configuração?

Sim, confira o guia de alteração de senha.

Como faço para verificar o número de série do dispositivo e onde registrá-lo?

  1. Primeiramente, pressione o botão Função do dispositivo (F para Ingenico, F1 para Verifone);
  2. Digite a senha (a senha padrão é 55555);
  3. No menu de configuração, selecione a opção DEVICE SETTINGS;
  4. Em seguida, selecione a opção SERIAL NUMBER;
  5. O registro do número de série é feito através da seção de gerenciamento de Dispositivos.

Como faço para redefinir o certificado já instalado em terminais Verifone EVO?

Entre em contato com seu fornecedor de terminais POS e solicite o arquivo de reset, que deverá ser utilizado em seguida para redefinir o certificado.

O que pode estar impedindo o dispositivo de baixar um novo arquivo?

Verifique os seguintes pontos:

  1. Se for uma aplicação ou um módulo, certifique que o deploy foi bem sucedido;
  2. Se for um arquivo comum ou uma imagem, certifique que o upload do arquivo ocorreu com sucesso. Você pode também limpar o cache do navegador e fazer o upload do arquivo novamente, para ter certeza que não foi nenhum problema no navegador.

Desenvolvimento

O que é o CloudWalk Manager?

O CloudWalk Manager é a ferramenta utilizada para liberar dispositivos, cadastrar aplicações, arquivos, números lógicos e grupos. É também através do CloudWalk Manager que é feita a gestão de usuários e por onde é realizado o monitoramento das transações efetuadas.

Como é o ambiente de desenvolvimento CloudWalk?

O ambiente de desenvolvimento CloudWalk ofecere uma interface simples, rápida e intuitiva, contando ainda com o inovador recurso de colaboração em tempo real, ou seja, múltiplos desenvolvedores podem trabalhar em uma mesma aplicação simultaneamente.

Confira a visão geral da IDE!

O que é POSXML?

POSXML (acrônimo para Point Of Sale eXtended Markup Language) é uma linguagem de programação utilizada para criar aplicações para terminais POS.

No desenvolvimento de aplicações para terminais POS, utilizam-se normalmente as linguagens de programação C ou C++, que exigem um conhecimento profundo tanto da especificação técnica do equipamento (hardware) quanto da linguagem de programação.

O objetivo principal da linguagem POSXML é simplificar o desenvolvimento de aplicações para os terminais POS, oferecendo um conjunto de instruções e de comandos pré-programados que permitem a interação direta com o dispositivo, resultando em uma grande redução no tempo de desenvolvimento de uma aplicação.

Qual é o tamanho máximo de uma String em POSXML?

O tamanho máximo de uma String é 1024 bytes.

Existem caracteres ou palavras reservadas na linguagem POSXML?

Todos os caracteres reservados na linguagem XML também são reservados na linguagem POSXML e devem ser escritos da maneira correta.

Os símbolos a seguir devem ser escritos da seguinte maneira:

< &lt;
> &gt;
& &amp;
' &apos;
" &quot;

Para mais informações, confira a estrutura da linguagem POSXML.

O serviço CloudWalk suporta o padrão ISO8583?

Sim. A linguagem POSXML e o serviço CloudWalk são compatíveis com o padrão ISO8583. Diversas aplicações CloudWalk já foram desenvolvidas e foram devidamente integradas com servidores ISO8583.

Você precisa de ajuda? Entre em contato e ficaremos felizes em te ajudar!

Existe um arquivo bitmap.dat de exemplo para transações ISO8583?

Sim, existe um exemplo de bitmap.dat que você pode utilizar como ponto de partida, mas lembre-se de verificar e atualizar os parametros e os tipos de cada bit de acordo com a espeficicação ISO8583 do seu servidor, antes de baixar o arquivo para os seus dispositivos.

Existe uma lista completa de comandos POSXML?

Sim, existe uma lista completa de comandos POSXML. Entretanto, se você estiver com dificuldade em descobrir como lidar com uma situação específica, nos envie uma mensagem que iremos lhe ajudar!

Como faço para definir uma imagem de fundo personalizada no dispositivo?

Devido a diversidade de dispositivos suportados pelo serviço CloudWalk, para usar uma imagem de fundo personalizada (background), é necessário seguir um conjunto de regras a fim de alcançar os melhores resultados para um dispositivo em particular.

Modelo do dispositivo Tipo do bitmap Nome do arquivo Exemplo
Verifone VX 680, VX 685, VX 820 Color (243 x 276) walk.bmp Visualizar
Verifone Verix 510, VX 520 Monochromatic (119 x 57) walk.bmp Visualizar
Ingenico iWL280 Color (245 x 156) walk.bmp Visualizar
Ingenico iCT250, iWL250, iPP350 Color (288 x 156) walk.bmp Visualizar
Ingenico iCT220, iPP320 Monochromatic (119 x 57) walk.bmp Visualizar

Depois de criar a sua imagem personalizada, siga estes passos:

  1. Vá para a seção de gerenciamento de Arquivos e faça o upload da imagem, seguindo a nomenclatura da tabela acima.
  2. Vá para a seção de gerenciamento de Aplicações e edite sua aplicação;
  3. Na lista de Arquivos da aplicação, selecione o arquivo bitmap previamente submetido e atualize a aplicação;
  4. Agora, assumindo que o dispositivo está associado com a aplicação que você acabou de adicionar a imagem, basta atualizar o dispositivo e o novo background será exibido.

Observação: Apenas imagens bitmap (.bmp) são suportadas. Outros formatos como JPG, GIF e PNG não são suportados.

O que é o servidor autorizador (host)?

Autorizador é o componente responsável para verificar e validar as informações fornecidas pelos terminais POS.

Leitura complementar: Autorizador

Como faço para definir a URL (endpoint) do autorizador?

A URL do autorizador é configurada diretamente na aplicação, através dos seguintes passos:

  1. Vá para a seção de gerenciamento de Aplicações e edite sua aplicação;
  2. Defina a URL, que pode ser http, https, tcp, tcps, etc;
  3. Agora, assumindo que o dispositivo está associado com a aplicação que você acabou de definir a URL do autorizador, você já está pronto para realizar os testes, e a nova URL será utilizada no encaminhamento das transações.

É possível definir várias URLs em uma mesma aplicação?

Não. Uma aplicação só pode ser associada a uma única URL. Note que os módulos em uso pela aplicação utilizam automaticamente a URL da aplicação.

No entanto, se você precisa que a mesma aplicação se comunique com várias URLs, você pode seguir estes passos:

  1. Crie a aplicação principal (por exemplo, myapp.posxml) apontando para uma das URLs (por exemplo, https://my-endpoint.com);
  2. Crie uma nova aplicação (por exemplo, activation.posxml) apontando para uma outra URL (por exemplo, https://activation.com), e nesta aplicação, o Rótulo deve ser definido como x, indicando que esta aplicação não deverá ser exibida. Observe que esta aplicação deve ser responsável pelo workflow completo de comunicação, incluíndo preconnect, network.send, network.receive e network.hostdisconnect;
  3. Repita o passo anterior enquanto for necessário, criando aplicações ocultas para todas as URLs;
  4. Agora, na aplicação principal (myapp.posxml), você pode utilizar o comando execute, que irá executar uma de suas aplicações ocultas, comunicando-se com a URL desejada.

O serviço CloudWalk possui uma API?

Sim! Confira a seção API para obter maiores informações.

Comunicação

Quais os tipos de comunicação suportados?

Isso depende do dispositivo, mas, em geral, os tipos de comunicação Ethernet, GPRS e discado são suportados.

Como faço para configurar o meu dispositivo Ethernet para usar DHCP?

Isso é muito simples! Basta definir o IP do dispositivo para 0.0.0.0, que após reinicia-lo, um IP deverá ser automaticamente atribuído a ele.

Ao utilizar GPRS, que APN, usuário e senha devem ser definidos?

Primeiramente você precisa verificar se o seu chip GPRS utiliza APN pública ou privada. Você pode obter esta informação diretamente com o fornecedor do chip.

Se você adquiriu o chip através de uma empresa de telecomunicações, como Lyra Network, ele provavelmente irá usar APN privada, caso contrário, ele deverá usar APN pública. O nome de usuário e a senha são informações que também devem ser solicitadas com o seu fornecedor.

Clientes brasileiros podem utilizar os provedores pré-configurados (CLARO, TIM, OI, VIVO, LYRA, etc), porém, clientes fora do Brasil devem escolher a opção Other operator e inserir manualmente as informações.

Por que o meu dispositivo não está se conectando?

Em geral, você pode assumir que o serviço CloudWalk está sempre disponível. Se você não tem certeza, basta verificar a página de status. Sendo assim, assumindo que o serviço CloudWalk está disponível, os problemas de comunicação devem estar relacionados com o seu POS, sua infra-estrutura ou algum tipo de configuração.

Problemas no POS

Ao solucionar problemas de comunicação, é essencial reduzir o leque de possibilidades, e você deve começar pelo seu dispositivo, de forma a ter certeza de que o mesmo está funcionando corretamente.

Problemas de infra-estrutura

Depois de se certificar de que o seu dispositivo está funcionando corretamente, o próximo passo é verificar sua infraestrutura.

  1. Verifique se o seu autorizador (host) está ativo e respondendo à solicitações.
  2. Para dispositivos Ethernet e wi-fi, certifique-se que sua conexão de rede está ativa e verifique se você pode acessar a Internet com um notebook ou um smartphone nesta mesma rede.
  3. Para dispositivos Ethernet e wi-fi, certifique-se de que não há restrições ou regras (firewall) na rede que possa bloquear a conexão do dispositivo.
  4. Para dispositivos Ethernet e discado, certifique-se de que o cabo não está danificado e que ele está conectado corretamente em ambas extremidades.
  5. Para dispositivos GPRS, certifique-se de que há sinal e verifique se o chip está funcionando normalmente (tente em outros dispositivos). Se o chip for pré-pago, verifique se o mesmo possui crédito.

Problemas de configuração

Partindo do princípio de que o problema não está relacionado com o seu dispositivo (problema físico) e que sua infraestrutura está funcional, o problema só pode estar relacionado com algum tipo de configuração:

  1. Certifique-se que o número de série do dispositivo está devidamente registrado no gerenciamento de Dispositivos.
  2. Para dispositivos Ethernet e wi-fi em uma rede com DHCP, o endereço IP deve ser 0.0.0.0, de forma que o IP seja atribuído pelo cliente DHCP.
  3. Para dispositivos Ethernet e wi-fi, certifique-se que os valores corretos foram definidos para Network Mask (ex: 255.255.255.0), Gateway (ex: 192.168.1.1), DNS 1 (ex: 8.8.8.8), DNS 2 (ex: 8.8.4.4) e SSL (ex: 0).
  4. Para dispositivos GPRS, verifique a configuração da APN. Talvez seja necessário entrar em contato com o seu provedor de telecomunicações para se certificar que tudo está correto.

Contratos e serviços

O que é uma transação?

Uma transação se caracteriza por toda e qualquer mensagem de dados proveniente de qualquer equipamento homologado e certificado com o CloudWalk Framework, com uma ou mais aplicações operacionais, integradas ao nossos servidores e demais autorizadores, via telecomunicação aplicável.

Note que todas as transações estão em conformidade com os padrões PCI e demais protocolos de segurança da CloudWalk, e as mesmas são sigilosas e de acesso exclusivo do cliente.

CloudWalk vende terminais POS?

Não, a CloudWalk oferece apenas o serviço. No entanto, se você precisa comprar terminais POS, entre em contato que ficaremos felizes em ajudar!

O servidor autorizador é incluído no serviço CloudWalk?

Não, o desenvolvimento e a manutenção do autorizador é de responsibilidade do cliente.