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
.
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
.