Consultar Chave Transacional

Requisitando ao servidor

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

{
  "type": "key"
}

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

let hasKeyRequest = {
  type: "key",
}

// 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 == "key") {
    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 eventHasKey do arquivo haskey.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": "key",
  "status": "success",
  "message": "Chave Zoop verificada com sucesso.",
  "hasKey": true
}

hasKey indica se a chave está presente no PIN Pad (true) ou não (false).

Falha durante a verificação

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

{
  "type": "key",
  "status": "failed",
  "message": "Falha ao verificar a chave Zoop.",
  "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.