Terminales cloud

Obtener terminal cloud

GET /v1/cloud-terminals/clients/{serialCode}

Obtiene el detalle de una terminal cloud a partir de su número de serie (serialCode), con su estado de conexión y las funcionalidades a las que está suscrita. Permite verificar que la terminal esté conectada y suscrita a PAYMENT_INTENTIONS antes de crear una intención de pago.

ParámetrosDescripción
serialCode
  • string
  • Número de serie de la terminal (parámetro de ruta)

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
ℹ️

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. También es 403 cuando la terminal indicada no pertenece al cliente o comercio de las credenciales.

Los campos sin valor se omiten de la respuesta.

Campos de la respuesta

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/{serial_code}?customerId={customer_id}' \
  --header 'Authorization: Bearer {access_token}'

200: OK

{
  "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"]
}
Listar terminales cloud