Saltar a contenido

Terminales

Listado y configuración de terminales MercadoPago Point.

Endpoints

GET /terminals

Lista terminales del cliente. Filtra por sucursal o caja del ERP.

Query parameters:

Param Tipo Descripción
sucursal_id string Filtrar por sucursal del ERP
caja_id string Filtrar por caja del ERP
limit number Máximo resultados (1-50, default 50)
offset number Offset para paginación 
# Todas las terminales
curl https://api.example.com/terminals \
  -H "x-api-token: mk_client_key"

# Filtrar por sucursal
curl "https://api.example.com/terminals?sucursal_id=SUC001" \
  -H "x-api-token: mk_client_key"

{
  "terminals": [
    {
      "id": "NEWLAND_N950__N950NCB801293324",
      "sucursal_id": "SUC001",
      "caja_id": "SUC001-POS001",
      "operating_mode": "PDV"
    }
  ]
}

Traducción de IDs

La API traduce automáticamente los IDs del ERP (sucursal_id, caja_id) a los IDs de MercadoPago para hacer la consulta, y devuelve los IDs del ERP en la respuesta.

PATCH /terminals/operating-mode

Cambia el modo operativo de todas las terminales de una caja.

Modos:

Modo Descripción
PDV Punto de Venta — controlado por el ERP
STANDALONE Autónomo — la terminal opera independiente 
curl -X PATCH https://api.example.com/terminals/operating-mode \
  -H "Content-Type: application/json" \
  -H "x-api-token: mk_client_key" \
  -d '{
    "caja_id": "SUC001-POS001",
    "operating_mode": "PDV"
  }'

{
  "message": "Operating mode updated",
  "terminals_updated": 1
}