Verificação de PIN Pad

Verificar a situação do PIN Pad

Com esta operação, você poderá verificar remotamente a situação do PIN Pad conectado à mesma máquina que o server.

Requisitando ao servidor:

Inicie a requisição enviando uma requisição em JSON com o seguinte campo:

{
  "type": "pinpad"
}

A requisição deve ser feita por meio de WebSocket, como no exemplo abaixo, em JavaScript.

let pinPadStatusRequest = {
  type: "pinpad",
}

// Onde `socket` é um objeto de `WebSocket`.
socket.send(JSON.stringify(pinPadStatusRequest))
socket.onmessage = (event) => {
  let response = JSON.parse(event.data)

  if (response == null) {
    return
  }

  if (response.type == "pinpad") {
    if (response.status == "success") {
      /* A verificação foi bem succedida, e dados adicionais poderão ser 
         extraídos dos campos da resposta. */
      return
    }

    if (response.status == "failed") {
      // Falha na verificação.
      // ...

      return
    }
  }
  // ...
}

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

Respostas:

O Zoop Desktop Server responderá em JSON, indicando em status:
- success: o sucesso da verificação;
- failed: ou a falha da verificação e a causa.

Sucesso na verificação:

Esta resposta sinaliza o sucesso da verificação. Dados adicionais sobre a situação do PIN Pad serão recebidos na resposta.

{
  "type": "pinpad",
  "status": "success",
  "message": "Situação do PIN Pad verificada com sucesso.",
  "isConnected": true,  // Se o PIN Pad está presente e conectado (true) ou não (false) | Booleano.
  "devicePort": "COM1", // Qual porta o PIN Pad está conectado                          | String.
}

O campo devicePort estará presente quando o valor de isConnected for igual a true.

Falha durante a verificação:

Caso ocorra alguma falha durante o processo, a resposta será como a seguir:

{
  "type": "pinpad",
  "status": "failed",
  "message": "Falha ao verificar a situação do PIN Pad.",
  "statusCode": -1,
}

O valor de statusCode será o código do erro que ocasionou a falha, sendo -1 caso não haja um código para a causa.