Terminales cloud

Listar terminales cloud

GET /v1/cloud-terminals/clients

Obtiene la lista paginada de terminales cloud, con su estado de conexión y las funcionalidades a las que están suscritas. Permite verificar que una terminal esté conectada y suscrita a PAYMENT_INTENTIONS antes de crear una intención de pago.

ℹ️

Las credenciales determinan qué terminales se pueden consultar. Con credenciales CUSTOMER se debe enviar el propio customerId y solo se obtienen las terminales del cliente. Con credenciales MERCHANT se debe enviar el propio merchantId y solo se obtienen las terminales del comercio. Si no se envía el identificador propio, o si se envía el de otro cliente o comercio, la respuesta es 403.

Los campos sin valor se omiten de la respuesta.

Parámetros de consulta

ParámetrosDescripción
customerId
  • (opcional)
  • string
  • Identificador del cliente. Se envía con credenciales CUSTOMER y debe ser el propio
merchantId
  • (opcional)
  • string
  • Identificador del comercio. Se envía con credenciales MERCHANT y debe ser el propio
serialCode
  • (opcional)
  • string
  • Filtra por número de serie de una terminal. Debe pertenecer al cliente o comercio de las credenciales
username
  • (opcional)
  • string
  • Filtra por nombre de usuario de la terminal
page
  • (opcional)
  • integer
  • Número de página (0-based). Por defecto: 0. Mínimo: 0
size
  • (opcional)
  • integer
  • Tamaño de página. Por defecto: 10. Rango: 1 a 100

Campos de cada terminal en data

ParámetrosDescripción
username
  • string
  • Nombre de usuario con el que la terminal se conecta
serial_code
  • string
  • Número de serie de la terminal
is_connected
  • boolean
  • Indica si la terminal está conectada
ip_address
  • (opcional)
  • string
  • Dirección IP de la terminal
last_connection_time
  • (opcional)
  • string
  • Fecha y hora de la última conexión
active_subscriptions_count
  • (opcional)
  • integer
  • Cantidad de suscripciones activas
keep_alive_seconds
  • (opcional)
  • integer
  • Intervalo de keep alive, en segundos
pending_message_queue_size
  • (opcional)
  • integer
  • Cantidad de mensajes pendientes de entrega
auth_expiration
  • (opcional)
  • string
  • Fecha y hora de vencimiento de la autenticación de la terminal
messages_awaiting_release_exactly_once
  • (opcional)
  • integer
  • Cantidad de mensajes a la espera de liberación
customer_id
  • array
  • Identificadores de los clientes asociados a la terminal
merchant_id
  • array
  • Identificadores de los comercios asociados a la terminal
country
  • (opcional)
  • string
  • País de la terminal
subscribed_features
  • array
  • Funcionalidades a las que la terminal está suscrita (hoy puede incluir PAYMENT_INTENTIONS)

Encabezados

Authorization: Bearer {access_token}
curl --location --request GET \
  'https://api.menta.global/api/v1/cloud-terminals/clients?customerId={customer_id}&page=0&size=10' \
  --header 'Authorization: Bearer {access_token}'

200: OK

{
  "data": [
    {
      "username": "00000000000001",
      "serial_code": "00000000000001",
      "is_connected": true,
      "ip_address": "203.0.113.10",
      "last_connection_time": "2026-10-02T19:27:15Z",
      "active_subscriptions_count": 2,
      "keep_alive_seconds": 60,
      "pending_message_queue_size": 0,
      "auth_expiration": "2026-10-03T19:27:15Z",
      "messages_awaiting_release_exactly_once": 0,
      "customer_id": ["00000000-0000-4000-8000-000000000001"],
      "merchant_id": ["00000000-0000-4000-8000-000000000002"],
      "country": "ARG",
      "subscribed_features": ["PAYMENT_INTENTIONS"]
    }
  ],
  "page": {
    "size": 10,
    "total_elements": 1,
    "total_pages": 1,
    "number": 0
  }
}
Obtener intención de pagoObtener terminal cloud