Verificação de PIN Pad

Com esta operação, você pode 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-sucedida, 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 está disponível no aplicativo de exemplo, na função eventIsPinPad do arquivo ispinpad.js.

Respostas

O Desktop Server responderá em JSON, indicando em status:

• success: sucesso da verificação;
• failed: 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,
  "devicePort": "COM1"
}

• isConnected: indica se o PIN Pad está presente e conectado (true) ou não (false).
• devicePort: indica em qual porta o PIN Pad está conectado. Este campo 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.