Desktop

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ões de crédito e/ou débito e com Pix 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 Desktop 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
}

Como instalar no Windows?

Basta executar o instalador da versão desejada disponível na seção de Downloads, mantendo a pasta padrão de instalação.

Como instalar no Linux…

…usando o pacote .deb?

• Primeiro, obtenha o instalador da versão X.Y.Z desejada aqui. Depois, instale o pacote usando o gerenciador de pacotes de sua distribuição Linux, como o dpkg em uma distribuição baseada em Debian.

$ sudo dpkg -i pinpad-server-installer_linux_X.Y.Z.deb

• Após instalado, basta executar o comando abaixo. Isto iniciará o servidor em segundo plano e ele estará apto a receber comandos via WebSocket.

$ pinpad-server

…usando Flatpak?

• O Flatpak é uma ferramenta para distribuir e executar aplicativos em diferentes distribuições Linux, fornecendo isolamento e garantindo que o aplicativo tenha todas as dependências necessárias.

Passo 1: Instalar o Flatpak (caso ainda não esteja instalado)

• Para distribuições baseadas em Debian/Ubuntu:

sudo apt update
sudo apt install flatpak

• Para distribuições baseadas em Fedora:

sudo dnf install flatpak

• Para distribuições baseadas em Arch Linux:

sudo pacman -S flatpak

• Consulte a documentação oficial do Flatpak aqui para instruções de outras distribuições Linux.

Passo 2: Adicionar o repositório Flathub

• O Flathub é o repositório padrão para aplicativos Flatpak.

flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

Passo 3: Instalar o runtime necessário

• O Zoop Desktop Server requer o runtime org.freedesktop.Platform na versão 23.08.

flatpak install flathub org.freedesktop.Platform//23.08

Passo 4: Instalar o Zoop Desktop Server

• Baixe o arquivo pinpad-server-installer_linux_{version}.flatpak da versão desejada aqui. Em seguida, instale o aplicativo usando o Flatpak:

flatpak install --user /caminho/para/o/pinpad-server-installer_linux_{version}.flatpak

• Observação: Substitua /caminho/para/o/pinpad-server-installer_linux_{version}.flatpak pelo caminho onde o arquivo foi baixado.

Passo 5: Executar o Zoop Desktop Server

• Após a instalação, você pode executar o aplicativo através do menu de aplicativos do seu ambiente gráfico ou pelo terminal:

flatpak run br.com.zoop.zooppcserver