Ir al contenido

Guía completa de Yap Terminal

Todo lo que tenés que hacer, verificar, y evitar — explicado paso a paso, para que cualquier persona del negocio lo pueda seguir sola.

Video completo (grabación real de la app, con narración). Si preferís leer en vez de ver, seguí bajando.

1. Instalar y activar

Antes de nada necesitás dos cosas que llegan por correo cuando te aprueban el acceso: el link de descarga del APK y tu código de activación (se ve así: A1B2-C3D4 — 4 caracteres, guion, 4 caracteres más, siempre en mayúscula, aunque si lo escribís en minúscula también funciona).

Qué hacer, paso a paso
  1. Abrí el link de descarga desde el teléfono donde vas a usar la app (no hace falta pasarlo por WhatsApp ni nada — el link del correo ya sirve).
  2. Instalalo. Android va a preguntar si permitís instalar "de origen desconocido" — es normal, la app no está en Play Store a propósito (así no depende de que Google la apruebe). Aceptá.
  3. Abrí la app. Vas a ver una pantalla que dice "Activar terminal" con un solo casillero de texto.
  4. Escribí el código de activación tal cual llegó en el correo y tocá "Activar".

¿Todavía no tenés código y solo querés probar la app? Escribí la palabra DEMO en ese mismo casillero — te va a pedir un registro rápido (nombre, comercio, correo) y vas a poder usar todo en modo prueba, sin tocar dinero real.

✔ Qué verificar: que la app deje de mostrar la pantalla de activación y pase directo al menú de Cobrar/Recibidos. Para confirmarlo del todo, andá a Ajustes — ahí tiene que aparecer una tarjeta con el nombre de tu comercio, el RUC, y la vigencia de la licencia. Si eso aparece, quedaste activo.
✘ Qué NO hacer:
  • No compartas tu código con nadie más — cada código sirve para UN solo equipo a la vez. Si otro celular lo usa primero, el tuyo queda bloqueado hasta que un administrador lo libere.
  • Si vas a cambiar de equipo o reinstalar, tocá primero "Desactivar dispositivo" en Ajustes (ícono rojo). Eso libera tu código para volver a usarlo. Si reinstalás sin hacer eso, va a hacer falta que un administrador lo libere manualmente por vos.

2. Activar el permiso de notificaciones

Este es el paso donde más gente se traba — léelo con calma, una sola vez, y no vas a tener problema.

Qué hacer
  1. En la app, tocá "Abrir ajustes" cuando te lo pida (te lleva directo a la pantalla de Android correcta, no hace falta buscarla vos).
  2. Buscá "Yap Terminal" en la lista y activá el interruptor.
  3. Volvé a la app — no hace falta tocar nada más, se activa solo. Si por algún motivo no se activa, hay un botón "Ya lo activé" como respaldo.
Problema conocido: la app no aparece en la lista, o el interruptor está trabado.

Le pasa a Android 13 o más nuevo con CUALQUIER app instalada fuera de Play Store — no es un error de Yap Terminal, y te va a volver a pasar cada vez que instalás o actualizás el APK. Se arregla así:

  1. Ajustes del teléfono → Apps → Yap Terminal.
  2. Tocá el menú de tres puntitos (⋮) arriba a la derecha.
  3. Elegí "Permitir ajustes restringidos".
  4. Recién ahí volvé al paso 1 de arriba — ahora sí va a aparecer.
✔ Qué verificar: en la pantalla del Notificador, tocá "Probar voz" — tiene que sonar. Después, si estás en Modo Demo, tocá "Simular cobro" con la pantalla apagada y confirmá que igual se escucha el anuncio. Eso demuestra que el permiso quedó bien puesto, sin arriesgar nada real.
✘ Qué NO hacer — el más importante de toda la guía:

Nunca deslices la app para cerrarla desde "Apps recientes" (el botón cuadrado o el gesto de deslizar hacia arriba para cerrar todo). Eso corta la conexión que le avisa a la app cuando llega un pago — y lo peor es que no te avisa: el ícono sigue diciendo "activo" pero deja de anunciar en silencio. Se arregla con solo volver a abrir la app una vez. Simplemente no la cierres desde ahí — dejala en segundo plano, tocando el botón de inicio nada más.

3. Que Android no "duerma" la app

Los celulares ahorran batería apagando apps que llevan rato sin usarse — y eso puede cortar el Notificador sin que te des cuenta. Hay dos cosas separadas que resolver (las dos hacen falta, una no reemplaza a la otra):

  1. La optimización de batería estándar de Android — la app te la pide directamente.
  2. El ahorro de batería PROPIO del fabricante (Samsung, Xiaomi, etc.) — para esto hay un botón dedicado en la app que te lleva directo a la pantalla de tu marca.
✔ Qué verificar: en Samsung, andá a "Cuidado del dispositivo → Batería → Administración de energía de apps" y confirmá que Yap Terminal (y las apps de donde te llegan los avisos: Yappy, Banco General, tu correo) NO estén en la lista de "apps que se ponen en reposo". Revisalo de vez en cuando — el propio Android puede volver a ponerla en reposo con el tiempo, aunque ya lo hayas arreglado una vez.
✘ Qué NO hacer:
  • No confíes solo en dejar la pantalla encendida — lo que de verdad ayuda es mantener el equipo enchufado en el mostrador (un teléfono enchufado nunca entra en el modo de ahorro más profundo).
  • No ignores las apps FUENTE (Yappy, Banco General, tu correo) — si esas se duermen, nunca se genera el aviso y el Notificador no tiene nada que escuchar. No es un fallo de Yap Terminal.

4. Cobrar con QR — los métodos que hay

Antes de cobrar: configurá tus credenciales

Esto es aparte de tu licencia — la licencia dice que tenés PERMITIDO cobrar, pero necesitás además cargar las credenciales de tu cuenta Yappy Comercial (una cuenta Yappy Personal no sirve para esto) en Ajustes → Configurar credenciales. Sin esto, la app ni te deja intentar cobrar — te va a mostrar una pantalla pidiéndote que las configures primero.

Los dos métodos
MétodoCómo funcionaCuándo usarlo
QR Dinámico La app genera y muestra un QR en pantalla con el monto exacto, para que el cliente lo escanee desde su celular. El caso normal — no necesitás nada extra, solo tu teléfono/tablet.
QR Físico La app NO muestra QR — asume que ya tenés un QR impreso/pegado en el mostrador (te lo da Yappy directamente al dar de alta "Yappy en Cajas") y el cliente lo escanea ahí. Solo si ya pediste ese QR físico a Yappy — si no lo tenés todavía, usá QR Dinámico.
✔ Qué verificar antes de cobrar en serio:
  • Probá primero en Modo Demo — genera un QR real pero que no mueve dinero, y podés forzar cómo se ve cada resultado (éxito, rechazado, expirado) desde Ajustes.
  • Revisá el monto en pantalla ANTES de tocar "Cobrar" — una vez generado el QR, ya no se puede editar, solo cancelar. Si usaste el micrófono para decir el monto, fijate en el mensaje que dice qué entendió la app antes de confirmar.
  • No des el producto hasta que la pantalla confirme el pago — el QR puede tardar hasta 5 minutos en confirmarse solo.
✘ Qué NO hacer:
  • No mezcles credenciales de Sandbox (pruebas) con modo Producción — si cambiás entre uno y otro en Ajustes, volvé a entrar a "Configurar credenciales" y guardalas de nuevo antes de cobrar, o vas a estar apuntando al lugar equivocado.
  • No canceles un cobro ya mostrado sin avisarle al cliente — cancelar anula la transacción del lado de Yappy también, y si el cliente ya estaba autorizando el pago en su teléfono, se puede confundir.
  • No uses una cuenta Yappy Personal para cobrar — tiene que ser Comercial.

5. Notificador — enterate de cada pago por voz

No todos los pagos te los van a cobrar vos por QR (a veces te pagan directo desde la app de Yappy del cliente). Para esos está el Notificador: escucha las notificaciones del teléfono y anuncia en voz alta cada pago recibido, aunque la pantalla esté apagada.

Las fuentes que podés activar
FuentePor defectoQué necesita
App de Yappy Activada Que la app de Yappy (Personal o Comercial) tenga sus notificaciones activas en Android.
Correo Apagada Que tu app de correo tenga notificaciones push activas para la cuenta donde te llegan los avisos de Yappy.
Banco General Apagada Que la app de Banco General tenga notificaciones push activas.

Se activan/desactivan con un interruptor cada una, directo en la pantalla del Notificador — no hace falta ninguna configuración técnica.

✔ Qué verificar:
  • En Modo Demo, tocá "Simular cobro" y confirmá que anuncia "Yappy recibido" con el monto correcto, y que el pago queda listado en "Pagos recibidos hoy".
  • Si tenés cuenta Comercial, confirmá también que un pago de esa cuenta anuncia "Yappy Comercial recibido" — no deben sonar igual, así sabés cuál cuenta recibió cada pago.
  • Si el mismo pago te puede llegar por dos vías (por ejemplo la App y también un correo), confirmá que se anuncia UNA sola vez, no duplicado.
✘ Qué NO hacer:
  • No actives Correo o Banco General "por si acaso" si en realidad no recibís pagos por esas vías — quedan apagadas por defecto justamente para evitar avisos de más o duplicados. Activalas solo si de verdad las usás.
  • No ignores el aviso de "Modo de prueba: quedan N captura(s) antes de agotar el cupo" en Demo — una vez agotado, el Notificador deja de reaccionar a pagos reales (podés seguir usando "Simular cobro" para practicar). Si de golpe "dejó de funcionar", revisá primero si es por esto.
  • "Silenciar voz" NO apaga el registro de pagos, solo la voz — para apagar todo hay que apagar "Notificador activo".

6. Checklist final — antes de usarlo con clientes reales

  • ☐ Activaste la app con tu código y ves tu comercio en Ajustes.
  • ☐ "Acceso a notificaciones" está concedido (si no aparecía, ya hiciste "Permitir ajustes restringidos").
  • ☐ Probaste "Simular cobro" con la pantalla apagada y se escuchó el anuncio.
  • ☐ Revisaste el ahorro de batería del fabricante — Yap Terminal y las apps fuente NO están en reposo.
  • ☐ El equipo va a quedar enchufado en el mostrador.
  • ☐ Cargaste tus credenciales de Yappy Comercial (si vas a cobrar por QR).
  • ☐ Hiciste un cobro de prueba completo en Modo Demo, de principio a fin.
  • ☐ Activaste solo las fuentes del Notificador que de verdad vas a usar.

7. ¿Algo no funciona?

Antes de escribirnos, revisá en este orden — resuelve la gran mayoría de los casos:

  1. ¿"Notificador activo" está encendido y "Silenciar voz" apagado?
  2. ¿"Acceso a notificaciones" sigue concedido? (revisar después de cada actualización de la app)
  3. ¿La app y las apps fuente están libres de la optimización de batería del fabricante?
  4. Si el pago aparece en tu Yappy pero nunca sonó ningún aviso: puede ser que Yappy no haya generado la notificación del sistema — eso hay que reportarlo a soporte de Yappy, no es algo que Yap Terminal pueda arreglar.

Si después de todo esto seguís con problemas, escribinos a quien te instaló la app con el mayor detalle posible (qué esperabas que pasara, qué pasó en cambio, y si podés, una captura de pantalla).