Point-of-sale icon

Verifique a conexão em nuvem

Verifique remotamente a conexão live WebSockets dos terminais.

Em uma integração em nuvem com a API de Terminais, os terminais estabelecem uma conexão de WebSockets para acessar a API de Terminais na nuvem. Nossa Support Team precisa habilitar websockets para você. Uma vez que os websockets estão habilitados, você pode verificar remotamente e em tempo real se os terminais estão ligados e têm uma conexão ao vivo na nuvem.
Você pode verificar isso:

Usando a Área do Cliente

Para verificar a partir de sua área de cliente se um terminal específico tem uma conexão de nuvem ao vivo para Terminal API:

  1. Na sua Customer Area, vá para In-person payments > Terminals.

  2. Selecione o terminal na lista.
    A página Settings > About this terminal é exibida.

  3. Em Cloud connection, selecione Check connection.
    Um ícone indica o resultado e uma mensagem é exibida:

    • -white_check_mark- Terminal está conectado
    • -x- Terminal está desconectado
    • O ícone de conexão não é atualizado automaticamente. Você precisa pressionar Check connection toda vez que quiser saber o estado atual.
    • Se você não vê Cloud connection, os WebSockets não estão habilitados para o terminal.

Use uma chamada de API

Usando a API /connectedTerminals, você pode obter uma lista de terminais registrados em uma conta de comerciante ou loja específica que tenham uma conexão em nuvem ao vivo. Você também pode verificar se um terminal específico tem uma conexão ao vivo na nuvem.

O endpoint a ser usado difere para terminais de teste e ativos:

  • Para terminais de teste: https://terminal-api-test.adyen.com/connectedTerminals
  • ara terminais ativos: https://terminal-api-live.adyen.com/connectedTerminals

Autentique suas solicitações usando a mesma chave de API que você usa para suas solicitações de Terminal API.

Para verificar se os terminais têm uma conexão ao vivo na nuvem para a API Terminal:

  1. Faça uma solicitação POST test ou live para o endpoint /connectedTerminals, especificando:

    Parâmetro Requerimento Descrição
    merchantAccount -white_check_mark- A conta do comerciante que você deseja verificar.
    store -x- A loja que você deseja verificar. Deve pertencer ao especificado merchantAccount.
    uniqueTerminalId -x- O POIID do terminal que você deseja verificar, no formato [modelo do dispositivo]-[número de série]. Deve pertencer ao especificado merchantAccount

    Aqui estão alguns exemplos de solicitações:

  2. Você recebe uma resposta com:

    • uniqueTerminalIds: Uma matriz com os POIIDs dos terminais que têm uma conexão ativa na nuvem. Se você verificou um terminal específico, o mesmo uniqueTerminalId a solicitação é retornado.

    Se a uniqueTerminalIds matriz da resposta estiver vazia, isso pode indicar:

    • Nenhum terminal encontrado com uma conexão ao vivo na nuvem.
    • WebSockets não estão habilitados.

Veja também