> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Códigos QR

> Cómo funcionan los códigos QR de Pix en Brasil — BR Codes estáticos, dinámico inmediato, cobrança con fecha de vencimiento, recurrencia de Pix Automático y retiro de Pix Saque.

Los códigos QR de Pix permiten a los usuarios pagar en aplicaciones, sitios web y puntos de venta físicos. Todos los participantes de Pix leen el mismo formato, por lo que los códigos funcionan entre instituciones.

Pix utiliza **payloads estructurados basados en EMV®** que BACEN estandariza. Cualquier institución puede codificar instrucciones de pago en este formato escaneable y legible por máquina.

Pix Switch genera, decodifica y valida códigos QR Pix EMV, y hace seguimiento de cada pago de cobro.

# Tipos de códigos QR Pix

***

Pix define dos categorías principales de códigos QR:

* **Código QR Estático** → reutilizable, estructura fija
* **Código QR Dinámico** → generado por transacción, con metadatos, conciliación y expiración

Las siguientes secciones describen cada tipo según los estándares de BACEN y el uso común del mercado.

# Código QR Estático

***

### Qué es

Un código QR Pix **reutilizable** contiene un payload fijo asociado a una clave Pix (correo electrónico, teléfono, CPF/CNPJ, EVP).

**No** expira. Puedes imprimirlo, compartirlo o exhibirlo, y sirve para escenarios de pago simples y de bajo volumen.

### Características

* Permanente y reutilizable
* No incorpora un monto por defecto (el pagador lo escribe)
* La forma más simple de aceptación Pix
* Funciona sin conexión (impreso, adhesivo, imagen)
* Compatible con el formato estático EMV Pix

### Casos de uso típicos

* Vendedores ambulantes, cafeterías, quioscos
* Profesionales (repartidores, barberos, tutores, freelancers)
* Campañas de donación
* Un punto de pago compartido por muchos pagadores

### Flujo de pago con código QR estático

1. El comerciante crea el código QR una vez.
2. El cliente lo escanea con cualquier aplicación habilitada para Pix.
3. El cliente escribe el monto.
4. El pago sigue el flujo estándar de Pix: validación → SPI → crédito.
5. La liquidación ocurre instantáneamente.

### Beneficios

* Fácil de crear e implementar
* Reutilizable sin límite
* Funciona bien en entornos físicos
* No necesita infraestructura adicional

### Limitaciones

* Sin conciliación automática
* El pagador escribe el monto, lo que arriesga un valor incorrecto
* No puede contener metadatos detallados (ID de pedido, factura y similares)

# Códigos QR Dinámicos

***

Cada código QR dinámico corresponde a una transacción y lleva un payload estructurado con:

* monto predefinido
* tiempo de expiración
* identificadores de conciliación
* metadatos (ID de pedido, descripción, detalles del pagador)

Añaden conciliación automática y trazabilidad, lo que conviene al comercio digital.

Pix Switch genera cobros dinámicos inmediatos. Todavía no genera códigos QR de fecha de vencimiento, recurrentes, de retiro o de cambio.

## Dinámico (Inmediato)

***

### Qué es

Un código QR de un solo uso para **pagos instantáneos**, con:

* un monto preestablecido
* una ventana de expiración corta
* un ID de correlación de transacción único

### Ideal para

* Checkout de comercio electrónico
* Aplicaciones de delivery
* Sistemas POS
* Restaurantes (por mesa o comanda)

### Características

* Fuerte soporte de metadatos y conciliación
* Expira automáticamente
* Uso único solamente
* Confirmación por webhook en tiempo real

## Pix Cobrança (Dinámico con Fecha de Vencimiento)

***

### Qué es

Un código QR dinámico para **pagos con fecha de vencimiento**, similar a una factura.

Lleva:

* fecha de vencimiento
* intereses y multas por mora
* descuentos o abatimientos
* identificación del pagador

### Ideal para

* Escuelas y universidades
* Cuotas de condominios o asociaciones
* Suscripciones o facturación recurrente
* Facturas profesionales

### Características

* Contiene información completa de facturación
* Permanece válido hasta la expiración
* La conciliación automática usa el ID del cobro

## Pix Automático (Recurrente)

***

Pix Automático establece **autorizaciones de cobro recurrente**.

El código QR sirve como la solicitud de consentimiento inicial para débitos periódicos.

### Ideal para

* Suscripciones
* Facturas de servicios públicos
* Servicios mensuales

## Pix Saque (Retiro)

***

### Qué es

Un código QR que permite al cliente **retirar efectivo** de un comerciante autorizado.

### Ideal para

* Tiendas minoristas que ofrecen conveniencia tipo cajero automático
* Farmacias, supermercados o tiendas de conveniencia

## Pix Troco (Cambio)

***

### Qué es

Un código QR para cuando el cliente paga **más que el monto de la compra**. El cliente recibe el producto y obtiene la diferencia de vuelta como Pix.

### Ideal para

* Supermercados
* Estaciones de servicio
* Tiendas de conveniencia

# Flujo de pago (todos los tipos de QR)

***

<Frame caption="Figura 1. Flujo de pago con código QR Pix">
  <img src="https://mintcdn.com/lerian-49cb71fc/ZrZBZTM4DWnrahSd/images/es/d2/payment-qrcode-flow.svg?fit=max&auto=format&n=ZrZBZTM4DWnrahSd&q=85&s=ced4b94a0327c557ff0f8b8ec4ac0753" alt="Flujo de pago de un código QR Pix, que abarca los tipos de QR estático y dinámico desde el escaneo hasta la liquidación" width="501" height="1210" data-path="images/es/d2/payment-qrcode-flow.svg" />
</Frame>

## Flujo de extremo a extremo del código QR Pix

***

1. **Creación del código QR**

   El comerciante o sistema crea un código QR Pix, ya sea estático (reutilizable) o dinámico (específico de transacción).

   Para un código QR dinámico, el payload puede contener un monto predefinido, una expiración e identificadores de conciliación.

2. **Iniciación del pago por el pagador**

   El pagador escanea el código QR con cualquier aplicación bancaria o billetera habilitada para Pix. El pagador revisa los detalles del pago antes de confirmar.

3. **Validación pre-transacción por la institución del pagador**

   Antes de enviar el pago, la institución del pagador ejecuta verificaciones obligatorias. Estas cubren estado de cuenta, saldo disponible, límites de transacción y riesgo interno.

4. **Liquidación a través de la infraestructura Pix**

   Tras la aprobación, el SPI de BACEN enruta la instrucción de pago para liquidación en tiempo real.

   Si ambas cuentas pertenecen a la misma institución, la institución puede liquidar internamente sin cruzar el SPI.

5. **Crédito instantáneo a la institución receptora**

   La institución receptora acredita los fondos a la cuenta del beneficiario justo después de la liquidación. Esto completa el pago.

6. **Confirmación y conciliación**

   Pix Switch emite notificaciones webhook con el resultado del pago a los backends del comerciante o sistema. Los backends luego concilian automáticamente, confirman el pedido y actualizan la contabilidad.

# Casos de uso típicos

***

### Estático

* Una panadería imprime un único código QR para el mostrador
* Una barbería comparte su código QR por WhatsApp
* Un vendedor ambulante exhibe un código QR laminado

### Dinámico Inmediato

* Checkout de comercio electrónico (un QR por pedido)
* Restaurantes que generan un código por mesa
* Aplicaciones de delivery que presentan un QR para cada entrega

### Dinámico con Fecha de Vencimiento

* Escuelas que generan una factura QR mensual
* Cuotas de condominio con reglas de interés o descuento
* Freelancers que emiten facturas

### Retiro / Cambio

* Una tienda ofrece Pix Saque en el mostrador
* Un cliente paga R$ 120 por una compra de R$ 98 y recibe R\$ 22 de vuelta como Pix Troco

# Notas regulatorias (BACEN)

***

Los códigos QR Pix deben cumplir con:

* **Especificación EMV® Merchant-Presented Mode (MPM)**
* Reglas de “Iniciação por QR Code” de Pix
* Validación CRC obligatoria
* Una estructura de campos definida para cobros dinámicos
* Reglas de expiración y facturación para Cobrança (QR con fecha de vencimiento)
* Límites de transacción y la ventana nocturna (cuando aplica)

<Tip>
  **Referencia regulatoria**

  Consulta siempre la [documentación oficial](https://www.bcb.gov.br/estabilidadefinanceira/pix-normas) del **Banco Central de Brasil (BACEN)** para detalles técnicos, legales y regulatorios. BACEN publica allí los cambios de reglas, plazos y requisitos oficiales.

  Los materiales de BACEN son la fuente autorizada para las regulaciones de Pix. Contienen las especificaciones más completas y actualizadas.
</Tip>
