API de integracionesCuota App
Integración de
dispositivos Android
Guía de capacidades para que un comercio gestione remotamente su flota Android — bloqueo por mora, control de apps, sincronización y más — usando su propia API key.
Tu flota Android, desde tu propio sistema
Cuota App administra los dispositivos Android enrolados de un comercio con un sistema de gestión remota integrado en el equipo desde su configuración inicial. Esta integración expone esas capacidades por API, para que un comercio con su propio sistema de cobranza o CRM pueda ejecutar los mismos comandos que el panel administrativo, sin depender de él.
El bloqueo por mora es una pantalla de bloqueo total impuesta por el propio cliente CuotaApp (kiosko) — no requiere un modo especial como en iOS. El enrolamiento queda integrado desde la configuración inicial del equipo, con acceso directo a apps, wallpaper y ciclo de sincronización del dispositivo.
Los comandos de esta guía son específicos de dispositivos Android y no son intercambiables con los de iPhones: cada plataforma tiene su propio set de acciones, reflejando cómo cada fabricante gestiona sus equipos.
Todo id de dispositivo (id / deviceId) acepta indistintamente el identificador numérico o el IMEI registrado.
Qué se puede hacer con un Android registrado
La tabla siguiente resume cada capacidad disponible. Todas se ejecutan como llamadas HTTP simples, autenticadas con la API key del comercio, y quedan acotadas a los dispositivos ya registrados en la flota.
| Capacidad | Qué permite hacer |
|---|---|
| Listar dispositivos | Consultar todos los dispositivos Android registrados del comercio, con su estado actual (activo, bloqueado, etc.). |
| Bloquear dispositivo | Bloquear remotamente el equipo ante mora o impago (pantalla de bloqueo total). Disponible por ID o por IMEI, con opción de aviso visible o silencioso. |
| Desbloquear dispositivo | Revertir el bloqueo y devolver el equipo a uso normal, con opción de aviso visible o silencioso. |
| Desprovisionar dispositivo | Dar de baja el equipo del control de financiamiento, por ejemplo cuando el cliente terminó de pagar y ya no debe quedar sujeto a bloqueo remoto. |
| Enviar notificación | Mandar un mensaje push personalizado (título + texto) directo a la pantalla del dispositivo, por ejemplo recordatorios de pago. |
| Bloquear/desbloquear apps | Restringir el acceso a aplicaciones específicas del equipo sin necesidad de bloquearlo por completo. |
| Cambiar fondo de pantalla | Reemplazar el wallpaper del dispositivo, por ejemplo para mostrar un aviso de mora directamente en la pantalla de inicio. |
| Quitar PIN/patrón de bloqueo | Eliminar remotamente el código de bloqueo nativo de Android, para que el cliente pueda volver a acceder al equipo. |
| Forzar sincronización inmediata | Pedirle al dispositivo que se conecte y sincronice de inmediato con el servidor, sin esperar el ciclo automático. |
| Permitir/bloquear instalación de APKs | Habilitar o restringir remotamente la instalación de aplicaciones fuera de Play Store. El bloqueo por mora siempre gana sobre este valor. |
Todas estas acciones quedan acotadas a los dispositivos del propio comercio y se ejecutan mediante llamadas simples a la API con su API key, sin necesidad de acceso al panel administrativo. Los comandos que modifican el equipo exigen además un header Idempotency-Key: un reintento con la misma clave nunca vuelve a ejecutar el comando dos veces.