# P@ssID Scanner — Guía de instalación y operación

> Versión de la app: **1.0.0** · Descarga: **https://scanme.passid.com.mx** · Noviembre 2026

P@ssID Scanner convierte una computadora con un **lector QR USB** en una puerta de acceso. Lees el QR del boleto,
P@ssID decide si pasa y la pantalla lo dice en grande, con color y sonido. **La decisión siempre la toma P@ssID**: la
computadora sólo lee y muestra. Sin internet no se aprueba a nadie.

---

## 1. Qué necesitas

| | |
|---|---|
| **Computadora** | Windows 10 u 11 (64 bits) · Mac con macOS 12 o más nuevo · Linux de 64 bits con escritorio |
| **Lector QR USB** | De los que funcionan **como teclado** («HID keyboard») y mandan **Enter** al terminar cada lectura (casi todos vienen así de fábrica) |
| **Internet** | Estable. Si el recinto no tiene buena señal, lleva un módem 4G/5G de respaldo |
| **Una cuenta de organizador de P@ssID** | Para crear la llave de la computadora |

No hace falta instalar nada más: la app ya trae todo lo que necesita.

## 2. Descargar e instalar

Entra a **https://scanme.passid.com.mx** desde la computadora de la taquilla y descarga el archivo de tu sistema.

### Windows
1. Descarga **PassIdScanner-1.0.0-windows-x64.exe**.
2. Ábrelo con doble clic. La primera vez Windows puede mostrar **«Windows protegió su PC»**: haz clic en
   **Más información** → **Ejecutar de todas formas**. (Pasa porque la app todavía no tiene firma de Microsoft.)
3. Opcional: guarda el archivo en el Escritorio para abrirlo rápido cada día.

### Mac
1. Descarga el de **Apple Silicon** (M1, M2, M3, M4…) o el de **Intel**. Si no sabes cuál: menú Apple → Acerca de esta Mac.
2. Abre el `.zip` y arrastra **P@ssID Scanner** a **Aplicaciones**.
3. La primera vez macOS dice que no puede comprobar al desarrollador. Ve a **Configuración del Sistema → Privacidad y
   seguridad**, baja hasta el aviso de P@ssID Scanner y elige **Abrir de todas formas**. (La app todavía no está
   notarizada por Apple.)

### Linux
1. Descarga **PassIdScanner-1.0.0-linux-x64.tar.gz** y descomprímelo.
2. En la carpeta `passid-scanner` ejecuta `./instalar.sh`. Queda en el menú de aplicaciones como **P@ssID Scanner**.

## 3. Crear la llave de la computadora (una vez por PC)

Cada computadora entra a P@ssID con **su propia llave**. Si roban o pierdes la computadora, revocas esa llave y ya no
sirve; las demás puertas siguen funcionando.

1. En el celular o en otra computadora, entra a **app.passid.com.mx** con tu cuenta de organizador.
2. Abre el **menú (☰) → Llaves de API**.
3. Escribe el nombre de la computadora (por ejemplo **Taquilla 1**).
4. Marca la casilla **«Sólo para escanear en la puerta»**. Con esa casilla la llave sólo sirve para validar boletos:
   no puede vender, reembolsar ni cambiar tus eventos.
5. Toca **Crear llave**. Aparece la llave y un **código QR**. **Déjalo en pantalla**: lo vas a leer con el lector en el
   siguiente paso. (La llave se muestra una sola vez; si cierras la pantalla, crea otra.)

## 4. Vincular la computadora

Abre P@ssID Scanner. La primera vez pide la llave:

![Pantalla Vincular](img/01-vincular.png)

**Lee con el lector el QR de la llave** que dejaste en pantalla. La app comprueba la llave con P@ssID y pasa sola a la
siguiente pantalla. Si no tienes el QR a la mano también puedes pegar la llave (`psk_…`) en el cuadro y tocar
**Vincular**.

Si por error lees el QR de un boleto, la app te lo dice:

![Vincular con un boleto](img/02-vincular-boleto-equivocado.png)

## 5. Elegir la función de hoy

![Elegir función](img/03-elegir-funcion.png)

Toca la función que recibe esta puerta. La de hoy aparece marcada con **HOY**. Un boleto de **otra función se rechaza
sin contar la entrada**, así que elige bien. La app recuerda la elección: mañana, si es otra función, toca
**Cambiar función**.

## 6. Escanear

![Lista para escanear](img/04-listo.png)

No hay que tocar nada: **lee el QR del boleto** y la pantalla responde. Puedes leer el siguiente en cuanto veas el
resultado.

| Pantalla | Qué significa | Qué haces |
|---|---|---|
| ![](img/05-adelante.png) **VERDE · ADELANTE** | P@ssID confirmó el boleto y **ya contó la entrada**. Si el boleto es para varias personas dice «Entró 2 de 4» | Deja pasar |
| ![](img/06-no-pasa-ya-usado.png) **ROJO · NO PASA** | P@ssID rechazó el boleto: ya se usó, es de otra función, está cancelado o no existe. Abajo dice el motivo | No dejes pasar. Si hay duda, manda a la persona a taquilla |
| ![](img/07-no-pasa-otra-funcion.png) **ROJO · otra función** | El boleto es de otra fecha u horario | Indica a la persona cuál es su función |
| ![](img/08-pasar-a-taquilla.png) **ÁMBAR · PASAR A TAQUILLA** | El boleto pide un código de acceso que la computadora no puede capturar | Manda a la persona a taquilla |
| ![](img/09-no-validado.png) **ÁMBAR · NO VALIDADO** | **No hubo respuesta de P@ssID** (sin internet, se tardó demasiado o falló el servidor). **No es un sí** | No dejes pasar todavía. Revisa la conexión y vuelve a leer el mismo QR |
| ![](img/10-lectura-no-reconocida.png) **LECTURA NO RECONOCIDA** | Lo leído no es un boleto de P@ssID (otro QR, un código de barras…) | Pide el QR del boleto |

**Sonidos:** dos tonos que suben = adelante · un tono grave doble = no pasa · tres tonos cortos = revisar. El botón
**Sonido** los apaga; los colores y el texto siguen igual.

**Contadores** (derecha): autorizados, rechazados y sin validar **en esta computadora** desde que se eligió la función.
Si hay varias puertas, el total del evento está en app.passid.com.mx.

**Lecturas repetidas:** si el lector lee dos veces el mismo QR en 3 segundos, la app repite el resultado sin contar
otra entrada (dice «lectura repetida»).

## 7. Si algo no funciona

| Síntoma | Solución |
|---|---|
| **Barra roja «La ventana no está al frente»** | El lector está escribiendo en otro programa. Haz clic en la barra o en la ventana de P@ssID Scanner. No abras otros programas en la computadora de la puerta |
| **Arriba dice SIN CONEXIÓN** | Revisa el internet (Wi-Fi o módem). Mientras tanto todo sale ámbar NO VALIDADO: no se aprueba a nadie |
| **El lector pita pero la pantalla no cambia** | El lector no está mandando Enter al final. Configúralo con el sufijo **Enter / CR** (viene en el manual del lector, normalmente es un código de configuración que se escanea) |
| **Todo sale LECTURA NO RECONOCIDA** | Prueba en el Bloc de notas que el lector escriba bien. Si escribe símbolos raros no pasa nada (la app los tolera); si no escribe nada, revisa el cable USB |
| **Vuelve sola a «Vincula esta computadora»** | La llave se revocó. Crea una nueva (paso 3) y vuelve a vincular |
| **Cambió la función** | Botón **Cambiar función** |
| **Quiero usar otra cuenta o entregar la computadora** | **Desvincular** (pide tocarlo dos veces) y revoca la llave en app.passid.com.mx |

**Pantalla completa:** tecla **F11**.

## 8. Seguridad

- **Una llave por computadora**, siempre con «Sólo para escanear en la puerta».
- Si se pierde una computadora: app.passid.com.mx → menú → Llaves de API → **Revocar**. Deja de funcionar al instante.
- La app no guarda los boletos ni los datos de los asistentes. En Windows la llave queda cifrada para tu usuario.
- Un error de conexión **nunca** se muestra en verde.

## 9. Datos para soporte

- Versión: abajo a la izquierda de la ventana. Si hay una versión nueva, la app lo avisa ahí mismo.
- Bitácora (sin datos de boletos ni de la llave): Windows `%LOCALAPPDATA%\PassIdScanner\logs` · Mac
  `~/Library/Application Support/PassIdScanner/logs` · Linux `~/.local/share/PassIdScanner/logs`.
