Capítulo 4

Primeiros passos

Aqui, você vai aprender sobre o novo Zoop Desktop Server e como iniciar no desenvolvimento do seu produto com o serviço da Zoop.

O que é o Zoop Desktop Server?

  • O Zoop Desktop Server é um serviço que permite que você integre o seu produto 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ão de crédito e débito usando PIN Pads.

Como funciona?

  • O Zoop Desktop Server é um serviço que roda em segundo plano no computador do seu cliente. A integração se dá por servidor Websocket, que permite que você envie e receba mensagens do Zoop PC server.

Como utilizar o Zoop Desktop Server?

  • Atualmente só é 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.
Exemplo de abertura do WebSocket com o Zoop Desktop Server (JavaScript)
let serverAddress = /* Endereço do seu servidor. */
let socket = new WebSocket(`ws://${serverAddress}:1337`)
socket.onopen = () => {
  // Inicializar o servidor com a requisição `initialize`.
}
socket.onerror = (error) => {
  /* Possivelmente registrar um log, ou reagir de acordo com o esperado para sua
     implementação de um aplicativo cliente. */
}
socket.onclose = () => {
  socket = null
}

Um exemplo mais completo pode ser encontrado no aplicativo de exemplo, na função clientWebSocket do arquivo websocket.js.