Si el escáner no está funcionando y tienes clientes esperando, esta guía va de lo más rápido de descartar a lo menos frecuente. Empieza por arriba: la mayoría de los casos se resuelven en los dos primeros pasos.
Primero: confirma que estás escaneando el QR correcto
Es el malentendido más común y el más fácil de pasar por alto, porque no da un error obvio — simplemente no pasa nada.
En Welcome Back hay dos códigos QR distintos y cada uno se escanea al revés del otro:
El QR del negocio es el que imprimes y pones en las mesas o el mostrador. Lo escanea el cliente con su celular para inscribirse y agregar su tarjeta al Wallet.
El QR del cliente es el que aparece en su tarjeta dentro de Apple Wallet o Google Wallet. Lo escanea tu equipo con el escáner para sumarle puntos.
Si tu equipo está apuntando el escáner al póster del local, no va a pasar nada. Son dos flujos distintos y nunca se cruzan.
Busca tu síntoma
La cámara no abre o se ve la pantalla en negro
Casi siempre es un permiso de cámara, o que otra app la está ocupando.
Cierra cualquier otra aplicación que use la cámara y vuelve a cargar la página.
En iPhone: Ajustes → Safari → Cámara → Permitir.
En Android: pulsa el candado en la barra de direcciones → Permisos → activa Cámara.
Dice "QR inválido" o no reconoce la tarjeta
Pide al cliente que abra la tarjeta desde su Wallet, no una captura de pantalla. Las capturas suelen perder definición y el lector no las interpreta bien.
Verifica que la pantalla del cliente tenga brillo suficiente y sin reflejos encima.
Te pide iniciar sesión de nuevo
Es normal después de varias horas sin uso: la sesión se vence por seguridad. Cierra el navegador por completo, vuelve a abrirlo y entra de nuevo con el usuario y la contraseña del escáner.
Aparece "Application error" o una pantalla en blanco
Borra el caché del navegador y vuelve a entrar.
Prueba en una ventana de incógnito.
Si persiste, prueba en otro navegador. Chrome es el más estable para el escáner.
El escáner va lento o se congela
Cierra las otras pestañas del navegador y revisa la conexión a internet del dispositivo. El escáner necesita conexión para registrar cada transacción.
Si falla en todos los escáneres a la vez
Cuando el problema aparece en todos los dispositivos al mismo tiempo, deja de buscar en el dispositivo — no es ahí. Revisa esto en orden:
El estado de tu suscripción. Si hubo un problema con el pago, el acceso al escáner se bloquea. Revísalo en tu perfil → Facturación.
La conexión a internet del local. Si se cayó el wifi, ningún escáner va a poder registrar.
La sesión de la cuenta. Cierra sesión y vuelve a entrar en uno de los dispositivos para descartarlo.
Qué hacer mientras tanto
No hagas esperar al cliente por el escáner. Pídele su teléfono o correo, atiéndelo normalmente, y registra la visita después desde la base de clientes del dashboard.
Es preferible corregir un registro más tarde que darle al cliente la impresión de que el programa no funciona.
Si nada de esto resuelve
Escríbenos por este chat con tres datos, así lo resolvemos en el primer mensaje en vez de ir preguntando de a uno:
Una captura de pantalla del error.
Qué dispositivo y navegador estás usando.
Si pasa en un escáner o en todos.
¿Tienes más preguntas? Escríbenos por este chat y te ayudamos.