Listado de Terminales

Obtenga la lista de todos los terminales asociados a la integración, con opciones de filtro y paginación.

Parámetros de búsqueda

Todos los parámetros son opcionales y se pueden combinar para refinar la búsqueda:

Parámetro	Tipo	Descripción	Ejemplo
terminalId	string	Filtrar por el ID del terminal	123456789
name	string	Filtrar por el nombre del terminal	loja-centro, armazem-norte
page	integer	Número de página (paginación)	1, 2, 3
limit	string	Número de resultados por página	10, 25, 50 (max: 500)
sort	string	Ordenar resultados	createdAt, -created_at, terminalId

Ejemplos

Listar todos los terminales

Solicitud

GET /terminals

Respuesta

{
 "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"
  },
  {
    "uuid": "1467a1e6-e6b5-425f-9810-21d428091068",
    "terminalId": "713149748",
    "name": "name",
    "model": "model",
    "processor": "processor",
    "supplier": "supplier",
    "features": {
      "allowRemoteTransactions": false,
      "allowGenerateQrCode": false,
      "allowRealTimeTransactionSinchronization": false
    },
    "createdAt": "2025-08-20T17:17:02+01:00",
    "updatedAt": "2025-08-29T11:06:52+01:00"
  },
 ],
 "meta": {
   "totalPages": 3,
   "totalCount": 6,
   "currentPage": 1
 },
 "links": {
   "first": "https://paypay.pt/api/terminals?sort=-createdAt%2CterminalId&limit=2&page=1",
   "last": "https://paypay.pt/api/terminals?sort=-createdAt%2CterminalId&limit=2&page=3",
   "next": "https://paypay.pt/api/terminals?sort=-createdAt%2CterminalId&limit=2&page=2"
 }
}

Múltiples filtros combinados

Solicitud

GET /terminals?terminalId=806030356&sort=-createdAt

Respuesta

{
 "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"
  }
 ],
 "meta": {
   "totalPages": 1,
   "totalCount": 1,
   "currentPage": 1
 },
 "links": {
   "first": "https://paypay.pt/api/terminals?sort=-createdAt%2CterminalId&limit=2&page=1",
   "last": "https://paypay.pt/api/terminals?sort=-createdAt%2CterminalId&limit=2&page=1"
 }
}

Estructura de la Respuesta

Campo	Tipo	Descripción
uuid	string	Identificador único del terminal
terminalId	string	ID del terminal
name	string	Nombre del terminal
model	string	Modelo del terminal
processor	string	Nombre del procesador de transacciones
supplier	datetime	Nombre del proveedor del terminal
features.allowRemoteTransactions	boolean	Indica si el terminal acepta transacciones remotas (solo compatible con terminales cloud)
features.allowGenerateQrCode	boolean	Indica si el terminal tiene la posibilidad de generar códigos QR
features.allowRealTimeTransactionSinchronization	boolean	Indica si el terminal sincroniza las transacciones en tiempo real con el backoffice de PayPay.
createdAt	datetime	Fecha de creación del registro
updatedAt	datetime	Fecha de la última actualización

important

Los terminales que tienen la funcionalidad allowRemoteTransactions activa, son los terminales del tipo Cloud.

Próximos Pasos

Ahora que ya sabe cómo listar terminales, explore:

• Información del Terminal - Información completa sobre un terminal específico.
• Enviar Solicitud de Pago - Enviar solicitud de pago al terminal cloud.