Configurar la app Android

La app captura la notificación de Yape en un teléfono dedicado del comercio, la guarda en el teléfono y la envía a la plataforma. Hotsale te entrega el APK firmado; la app no está en Play Store.

Antes de empezar

• Un teléfono Android con la app de Yape que recibe los pagos de tu negocio.
• Acceso al panel para generar el código de vinculación.
• Conexión a internet (wifi o datos).

Instalar y vincular

1. Instala el APK que te entregó Hotsale. Si Android lo pide, permite instalar apps de esa fuente solo para este paso.

2. Genera un código en el panel: Dispositivos → Vincular dispositivo → Generar código de activación. Elige el entorno (test o live). El código tiene la forma HS-XXXXXX-XXXXXX, vence en 15 minutos y sirve una sola vez.

3. Abre la app. La primera pantalla dice «Ingresa el código de vinculación que te dio tu administrador para usar la app.» Escribe los 12 caracteres (el prefijo HS- y el guion se ponen solos) o usa Pegar código, y toca Entrar.

4. Concede el acceso a notificaciones. Toca Abrir acceso a notificaciones y activa HotsalePay en la lista del sistema. Sin este permiso la app no ve los pagos.

5. Quita la optimización de batería para HotsalePay y permite el inicio automático si tu marca lo ofrece (Xiaomi, Huawei, Oppo, Samsung…). Algunas marcas cierran apps en segundo plano y dejarían al detector «ciego».

6. Comprueba en Inicio que dice Detector activo y, en Sistema, Vinculado · tu tienda.

Nota

Por defecto cada tienda tiene un dispositivo. Si vinculas otro teléfono, el anterior queda revocado.

Las pantallas

Pestaña	Para qué
Inicio	Estado del detector, actividad de hoy y última notificación
Pagos	Lista de yapeos detectados, con su estado y el pedido cuando se concilia
Ingresos	Totales detectados por periodo; exporta a CSV
Sistema	Vínculo con la tienda, permisos, batería y diagnóstico

Mensajes que puedes ver

Mensaje	Qué significa	Qué hacer
Falta permiso de notificaciones	El sistema le quitó el acceso a la app	Toca el aviso y vuelve a activarlo
Sin vincular	La app no tiene código válido	Genera un código en el panel e ingrésalo
Hay que volver a vincular	El servidor rechazó las credenciales del teléfono	Genera un código nuevo
Detenido por el servidor (licencia o dispositivo)	Licencia suspendida o dispositivo revocado	Los pagos quedan guardados; contacta a soporte
Esperando la primera notificación de Yape	Todo listo, aún no llega ningún yapeo	Haz un yapeo de prueba

Buenas prácticas

• Deja el teléfono cargando y con conexión. La app reintenta sola si no hay red y envía todo al volver.
• No cierres la app desde recientes ni uses «limpiadores».
• Si cambias de teléfono, vincula el nuevo con un código nuevo; el anterior se revoca solo.
• El panel avisa cuando el teléfono deja de enviar señal.