Android

Primeiros passos

Aqui, você vai aprender sobre o novo Zoop Desktop Server para Android no totem Gertec Smart SK210.

O que é o Zoop Desktop Server?

  • O Zoop Desktop Server para Android é um aplicativo Android que permite que você integre o seu produto Android com a Zoop. Com ele, você pode criar um aplicativo que se conecta com a Zoop e permite que seus clientes aceitem pagamentos com cartões de crédito e/ou débito e com Pix usando um PIN Pad conectado ao dispositivo Android suportado.

Como funciona?

  • O Zoop Desktop Server para Android é um serviço que roda no totem Gertec Smart SK210 junto com um aplicativo Android do seu cliente. A integração se dá por servidor WebSocket, que permite que você envie e receba mensagens do Zoop Desktop Server.

Como utilizar o Zoop Desktop Server?

  • A versão para Android tem o mesmo funcionamento da versão para desktop. Assim, apenas é possível integrar com o Zoop Desktop Server através do protocolo WebSocket (ws://).
  • Ao inicializar o Zoop Desktop Server, um servidor WebSocket é aberto na porta 1337 e acessível pela URL ws://{endereço do servidor}:1337.
    • Exemplo: se o Zoop Desktop Server for inicializado e acessado dentro da mesma máquina, a URL será ws://localhost:1337.

Caso você deseje implementar um aplicativo Android, é possível implementar um WebSocket client usando alguma biblioteca com o suporte necessário, como a Ktor.

Como instalar no Android?

O arquivo APK da versão desejada (a partir da versão 3.8.0) pode ser baixado na seção de Releases.

Uma vez instalado, basta iniciar o aplicativo com o nome Zoop Desktop Server. O WebSocket para integração é iniciado e está pronto para receber requisições.

O processo que inicia o Zoop Desktop Server é executadao em um serviço foreground do Android. Por isso, o aplicativo é iniciado em background e pode ser finalizado. O acompanhamento da execução do servidor é feito por uma notificação do sistema Android.

É necessário desativar o modo desenvolvedor do Android. Para isso, acesse o caminho Configurações > Sistema > Avançado > Opções do desenvolvedor e desative essa configuração.

É altamente recomendado manter apenas o PIN Pad conectado no totem, removendo quaisquer outros dispositivos das portas USB e USB-C (incluindo a conexão com as ferramentas de desenvolvimento Android).