Consultar dados do terminal

Consulte informações detalhadas de um terminal específico através do seu UUID.

Endpoint

GET /api/v1/terminals/{uuid}

Parâmetro

Parâmetro	Tipo	Obrigatório	Descrição
uuid	string	✅ Sim	UUID do terminal a consultar

Exemplo

Pedido

GET /terminals/3df21709-b2f5-4ec6-93f9-c5855e0da879

Resposta

{
 "date": "2021-12-07T18:01:19+00:00",
 "success": true,
 "data": {
    "uuid": "3df21709-b2f5-4ec6-93f9-c5855e0da879",
    "terminalId": "806030356",
    "name": "name",
    "model": "model",
    "processor": "processor",
    "supplier": "supplier",
    "features": {
      "allowRemoteTransactions": true,
      "allowGenerateQrCode": false,
      "allowRealTimeTransactionSinchronization": true
    },
    "createdAt": "2025-08-21T09:46:39+01:00",
    "updatedAt": "2025-08-22T16:16:56+01:00"
  }
}

Estrutura da Resposta

Campo	Tipo	Descrição
uuid	string	Identificador único do terminal
terminalId	string	Id do terminal
name	string	Nome do terminal
model	string	Modelo do terminal
processor	string	Nome do processador das transações
supplier	datetime	Nome do fornecedor do terminal
allowRemoteTransactions	boolean	Indica se o terminal aceita transações remotas (Suportado apenas em terminais cloud)
allowGenerateQrCode	boolean	Indica se o terminal tem a possibilidade de gerar QR Codes
allowRealTimeTransactionSinchronization	boolean	Indica se o terminal sincroniza as transações em realtime com o backoffice PayPay
createdAt	datetime	Data de criação do registo
updatedAt	datetime	Data da última atualização

Terminais Cloud

Os terminais que têm a funcionalidade allowRemoteTransactions ativa, são os terminais do tipo Cloud.

Próximos Passos

Com acesso aos detalhes do terminal, pode:

• Enviar Pedido de Pagamento - Enviar pedido de pagamento para terminal cloud
• Enviar Pedido de Reembolso - Enviar pedido de devolução para terminal cloud
• Configurar Webhooks - Receber notificações em tempo real