Pago con QR estático

El QR es una imagen impresa físicamente que el cliente escanea. Solo funciona cuando existe una orden pendiente por pagar; de lo contrario, el cliente verá “QR expirado”.

Cómo obtener el QR estático

En Yappy Comercial: Productos → Yappy en Caja.
En la fila del grupo deseado, presiona los tres puntos (⋮) → Editar unidades de cobro.
Presiona el botón Descargar QR.
Selecciona las cajas para las que necesitas el QR.
Recibirás una imagen con el QR asignado a cada caja seleccionada.
Imprime el QR y colócalo físicamente en la caja correspondiente.

Flujo end-to-end con QR estático

sequenceDiagram
  participant C as Caja
  participant B as Backend del comercio
  participant Y as Yappy API
  participant A as Yappy App

  Note over C: QR ya impreso<br/>y visible al cliente

  C->>B: Iniciar caja
  B->>Y: POST /session/device
  Y-->>B: token

  C->>B: Iniciar cobro de $X
  B->>Y: POST /qr/generate/HYB
  Y-->>B: transactionId
  Note over B: La orden queda<br/>asociada al QR físico

  loop Polling cada 2-5 seg
      B->>Y: GET /transaction/{id}
      Y-->>B: status=PENDING
  end

  A->>Y: Cliente escanea QR impreso<br/>y paga

  B->>Y: GET /transaction/{id}
  Y-->>B: status=COMPLETED
  B-->>C: Imprime factura

Cómo funciona el QR estático

El QR impreso es el mismo siempre, pero solo se vuelve “activo” cuando llamas a POST /qr/generate/HYB para esa caja. Si un cliente escanea sin que haya una orden pendiente, verá “QR expirado”. Un QR estático solo puede tener una orden activa a la vez.

Diferencias clave con el QR dinámico

Aspecto	QR Dinámico (DYN)	QR Estático (HYB)
Endpoint	`/qr/generate/DYN`	`/qr/generate/HYB`
Respuesta incluye `hash`	Sí — para renderizar el QR	No — el QR físico ya existe
Requiere pantalla en caja	Sí	No
Caso de uso ideal	POS con pantalla / TPV	Ferias, domicilios, mostradores sin pantalla

¿Te fue útil esta página?