Terminales
Aprovisionamiento de una terminal POS para una sucursal. El flujo completo de onboarding — registrar un dispositivo, vincular un procesador, vincular una cuenta, activar — se cubre en Pagos con terminal → Onboarding.
Esta página se enfoca en la vista del lado del comercio: quién puede ver cuáles terminales, cómo gestionarlas a lo largo del tiempo y cómo se relacionan con sucursales y negocios.
Una terminal específica que un usuario puede operar
El operador (empleado del comercio) accede a una terminal mediante su authUserId y el deviceId de la terminal:
curl https://api.ali.app/rest/devices/users/{authUserId}/terminals/{deviceId} \
-H "Authorization: Bearer <token>"
Una ruta equivalente se expone bajo el recurso de negocios:
curl https://api.ali.app/rest/businesses/users/{authUserId}/terminals/{deviceId} \
-H "Authorization: Bearer <token>"
Ambas devuelven la misma terminal; la forma /devices/... es la canónica a usar, y la forma /businesses/... es un alias heredado. No existe una ruta pública del gateway que liste todas las terminales de un usuario sin un deviceId.
Transacciones en una terminal
# Listar (historial completo de transacciones del dispositivo)
curl "https://api.ali.app/rest/devices/{deviceId}/transactions" \
-H "Authorization: Bearer <token>"
# Transacción individual
curl https://api.ali.app/rest/devices/{deviceId}/transactions/{transactionId} \
-H "Authorization: Bearer <token>"
Actualizar una terminal
curl -X PATCH https://api.ali.app/rest/businesses/terminals/{deviceId} \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{ "isActive": false }'
| Campo | Tipo | Requerido |
|---|---|---|
isActive | boolean | ✅ |
newDeviceId | string | — |
externalTerminalId | string | — |
terminalType | enum | — |
Este endpoint no reasigna una terminal a una sucursal distinta — no hay un campo branchId. Para dar de baja una terminal, establece "isActive": false.
Eliminar una terminal
curl -X DELETE https://api.ali.app/rest/businesses/terminals/{deviceId} \
-H "Authorization: Bearer <token>"
Irreversible — el dispositivo físico debe reenviarse a Migo si el comercio quiere volver a usarlo.
Estado de la terminal
| Estado | Significado |
|---|---|
registered | Dispositivo registrado, aún sin procesador vinculado |
configuring | Handshake del procesador en curso |
active | Puede aceptar pagos |
suspended | Deshabilitada temporalmente (uso indebido, marca de riesgo) |
closed | Eliminada de forma permanente |