> ## 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.

# QR Codes

> Como os QR Codes Pix funcionam no Brasil: BR Codes estáticos, dinâmicos imediatos, cobrança com vencimento, recorrência do Pix Automático e saque com Pix Saque.

Os QR Codes Pix permitem que os usuários paguem em aplicativos, sites e pontos de venda físicos. Cada participante do Pix lê o mesmo formato, então os códigos funcionam entre instituições.

O Pix usa **payloads estruturados baseados em EMV®** que o BACEN padroniza. Qualquer instituição pode codificar instruções de pagamento nesse formato escaneável e legível por máquina.

O Pix Lerian gera, decodifica e valida QR Codes Pix EMV, e acompanha cada pagamento de cobrança.

# Tipos de QR Code Pix

***

O Pix define duas categorias principais de QR Code:

* **QR Code estático** → reutilizável, estrutura fixa
* **QR Code dinâmico** → gerado por transação, com metadados, conciliação e expiração

As seções abaixo descrevem cada tipo diante dos padrões do BACEN e do uso comum de mercado.

# QR Code estático

***

### O que é

Um QR Code Pix **reutilizável** guarda um payload fixo ligado a uma chave Pix (e-mail, telefone, CPF/CNPJ, EVP).

Ele **não** expira. Você pode imprimir, compartilhar ou mostrar o código, e ele serve para cenários de pagamento simples e de baixo volume.

### Características

* Permanente e reutilizável
* Não embute um valor por padrão (o pagador digita o valor)
* Forma mais simples de aceitação do Pix
* Funciona offline (impresso, adesivo, imagem)
* Está em conformidade com o formato estático EMV Pix

### Casos de uso típicos

* Vendedores de rua, cafés, quiosques
* Profissionais (entregadores, barbeiros, professores particulares, freelancers)
* Campanhas de doação
* Um ponto de pagamento compartilhado por muitos pagadores

### Fluxo de pagamento do QR Code estático

1. O lojista cria o QR Code uma vez.
2. O cliente escaneia o código com qualquer aplicativo habilitado para Pix.
3. O cliente digita o valor.
4. O pagamento segue o fluxo padrão do Pix: validação → SPI → crédito.
5. A liquidação acontece na hora.

### Benefícios

* Fácil de criar e colocar em uso
* Reutilizável sem limite
* Funciona bem em ambientes físicos
* Não precisa de infraestrutura extra

### Limitações

* Sem conciliação automática
* O pagador digita o valor, o que gera risco de valor errado
* Não pode guardar metadados detalhados (ID do pedido, fatura e afins)

# QR Codes dinâmicos

***

Cada QR Code dinâmico se aplica a uma transação e carrega um payload estruturado com:

* valor predefinido
* tempo de expiração
* identificadores de conciliação
* metadados (ID do pedido, descrição, dados do pagador)

Eles acrescentam conciliação automática e rastreabilidade, o que serve ao comércio digital.

O Pix Lerian gera cobranças dinâmicas imediatas. Ele ainda não gera QR Codes com vencimento, recorrentes, de saque ou de troco.

## Dinâmico (imediato)

***

### O que é

Um QR Code de uso único para **pagamentos instantâneos**, com:

* um valor predefinido
* uma janela curta de expiração
* um ID único de correlação da transação

### Ideal para

* Checkout de e-commerce
* Aplicativos de entrega
* Sistemas de POS
* Restaurantes (por mesa ou comanda)

### Características

* Forte suporte a metadados e conciliação
* Expira automaticamente
* Apenas uso único
* Confirmação por webhook em tempo real

## Pix Cobrança (dinâmico com vencimento)

***

### O que é

Um QR Code dinâmico para **pagamentos com vencimento**, parecido com uma fatura.

Ele carrega:

* data de vencimento
* juros e multa por atraso
* descontos ou abatimentos
* identificação do pagador

### Ideal para

* Escolas e universidades
* Taxas de condomínio ou de associação
* Cobrança por assinatura ou recorrente
* Faturas profissionais

### Características

* Guarda as informações completas de cobrança
* Permanece válido até a expiração
* A conciliação automática usa o ID da cobrança

## Pix Automático (recorrente)

***

O Pix Automático configura **autorizações de cobrança recorrente**.

O QR Code serve como a solicitação inicial de consentimento para débitos periódicos.

### Ideal para

* Assinaturas
* Contas de consumo
* Serviços mensais

## Pix Saque (saque)

***

### O que é

Um QR Code que permite que um cliente **saque dinheiro** em um lojista autorizado.

### Ideal para

* Lojas de varejo que oferecem a conveniência de um caixa eletrônico
* Farmácias, supermercados ou lojas de conveniência

## Pix Troco (troco)

***

### O que é

Um QR Code para quando o cliente paga **mais do que o valor da compra**. O cliente recebe o produto e recebe a diferença de volta como um Pix.

### Ideal para

* Supermercados
* Postos de combustível
* Lojas de conveniência

# Fluxo de pagamento (todos os tipos de QR)

***

<Frame caption="Figura 1. Fluxo de pagamento com QR Code Pix">
  <img src="https://mintcdn.com/lerian-49cb71fc/TGLv2g3qhXqf0dqb/images/pt/d2/payment-qrcode-flow.svg?fit=max&auto=format&n=TGLv2g3qhXqf0dqb&q=85&s=4fcf6d813a9fb6ea4ba7ceeb7a7b5574" alt="Fluxo de pagamento de um QR Code Pix, cobrindo os tipos estático e dinâmico, do escaneamento à liquidação" width="544" height="1194" data-path="images/pt/d2/payment-qrcode-flow.svg" />
</Frame>

## Fluxo ponta a ponta do QR Code Pix

***

1. **Criação do QR Code**

   O lojista ou o sistema cria um QR Code Pix, estático (reutilizável) ou dinâmico (específico da transação).

   Para um QR Code dinâmico, o payload pode guardar um valor predefinido, uma expiração e identificadores de conciliação.

2. **Iniciação do pagamento pelo pagador**

   O pagador escaneia o QR Code com qualquer aplicativo de banco ou de carteira habilitado para Pix. O pagador revisa os detalhes do pagamento antes da confirmação.

3. **Validação pré-transação pela instituição do pagador**

   Antes de enviar o pagamento, a instituição do pagador roda verificações obrigatórias. Elas cobrem o status da conta, o saldo disponível, os limites de transação e o risco interno.

4. **Liquidação pela infraestrutura do Pix**

   Depois da aprovação, o SPI do BACEN roteia a instrução de pagamento para liquidação em tempo real.

   Se as duas contas pertencem à mesma instituição, a instituição pode liquidar internamente sem passar pelo SPI.

5. **Crédito instantâneo para a instituição recebedora**

   A instituição recebedora credita os recursos na conta do beneficiário logo após a liquidação. Isso conclui o pagamento.

6. **Confirmação e conciliação**

   O Pix Lerian emite notificações de webhook com o resultado do pagamento para os backends do lojista ou do sistema. Os backends então conciliam automaticamente, confirmam o pedido e atualizam a contabilidade.

# Casos de uso típicos

***

### Estático

* Uma padaria imprime um único QR Code para o balcão
* Uma barbearia compartilha o QR Code dela no WhatsApp
* Um vendedor de rua mostra um QR Code plastificado

### Dinâmico imediato

* Checkout de e-commerce (um QR por pedido)
* Restaurantes que geram um código por mesa
* Aplicativos de entrega que apresentam um QR para cada entrega

### Dinâmico com vencimento

* Escolas que geram uma fatura mensal em QR Code
* Taxas de condomínio com regras de juros ou desconto
* Freelancers que emitem faturas cobradas

### Saque / Troco

* Uma loja oferece Pix Saque no balcão
* Um cliente paga R$ 120 por uma compra de R$ 98 e recebe R\$ 22 de volta como Pix Troco

# Notas regulatórias (BACEN)

***

Os QR Codes Pix devem estar em conformidade com:

* **Especificação EMV® Merchant-Presented Mode (MPM)**
* Regras do Pix “Iniciação por QR Code”
* Validação CRC obrigatória
* Uma estrutura de campos definida para cobranças dinâmicas
* Regras de expiração e de cobrança para a Cobrança (QR com vencimento)
* Limites de transação e a janela noturna (quando se aplica)

<Tip>
  **Referência regulatória**

  Consulte sempre a [documentação oficial](https://www.bcb.gov.br/estabilidadefinanceira/pix-normas) do **Banco Central do Brasil (BACEN)** para detalhes técnicos, jurídicos e regulatórios. O BACEN publica ali as mudanças de regras, os prazos e os requisitos oficiais.

  Os materiais do BACEN são a fonte autoritativa para as regulamentações do Pix. Eles guardam as especificações mais completas e atuais.
</Tip>
