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

> Os QR Codes Pix são um dos métodos de iniciação de pagamento mais amplamente adotados no Brasil.

Eles oferecem uma forma rápida, intuitiva e segura para os usuários realizarem pagamentos em aplicativos, sites e ambientes físicos — garantindo interoperabilidade entre todos os participantes do Pix.

O Pix utiliza **payloads estruturados baseados no padrão EMV®**, padronizados pelo BACEN, permitindo que qualquer instituição codifique instruções de pagamento em um formato escaneável e legível por máquina.

O Pix Plugin suporta o ciclo de vida completo dos QR Codes Pix EMV, incluindo geração, decodificação, validação e liquidação.

# Tipos de QR Codes Pix

***

O Pix define duas categorias principais de QR Codes:

* **QR Code Estático** → reutilizável, estrutura fixa
* **QR Code Dinâmico** → gerado por transação, suporta metadados, reconciliação e expiração

Abaixo, cada tipo é detalhado de acordo com os padrões do BACEN e o uso típico do mercado.

# QR Code Estático

***

### O que é

Um QR Code Pix **reutilizável** que contém um payload fixo associado a uma chave Pix (e-mail, telefone, CPF/CNPJ, EVP).

Ele **não expira**, pode ser impresso, compartilhado ou exibido livremente, e é ideal para cenários de pagamento simples ou de baixa complexidade.

### Características

* Permanente e reutilizável
* Não incorpora um valor por padrão (o pagador insere manualmente)
* Forma mais simples de aceitação Pix
* Funciona offline (impresso, adesivo, imagem)
* Totalmente compatível com o formato estático Pix EMV

### Casos de uso típicos

* Vendedores ambulantes, cafeterias, quiosques
* Profissionais (entregadores, barbeiros, tutores, freelancers)
* Campanhas de doação
* Ponto único de pagamento compartilhado por muitos pagadores

### Fluxo de pagamento com QR Code Estático

1. O comerciante cria o QR Code uma vez.
2. O cliente escaneia usando qualquer aplicativo habilitado para Pix.
3. O usuário insere o valor manualmente.
4. O pagamento segue o fluxo padrão de processamento Pix: validação → SPI → crédito.
5. A liquidação ocorre instantaneamente.

### Benefícios

* Fácil de gerar e implantar
* Reutilizável indefinidamente
* Funciona bem em ambientes físicos
* Não necessita de infraestrutura

### Limitações

* Sem reconciliação automática
* O pagador deve digitar o valor → risco de valor incorreto
* Não permite incluir metadados detalhados (ID do pedido, fatura, etc.)

# QR Codes Dinâmicos

***

QR Codes Dinâmicos são **gerados por transação** e contêm um payload estruturado com:

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

Eles proporcionam liquidação automatizada, rastreabilidade e uma melhor experiência do usuário, sendo o método preferido para o comércio digital.

O Pix Plugin suporta todas as principais modalidades dinâmicas do Pix.

## 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 de correlação de transação único

### Ideal para

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

### Características

* Forte suporte a metadados e reconciliação
* Expira automaticamente
* Não pode ser reutilizado
* Confirmação em tempo real via webhook

## Pix Cobrança (Dinâmico com Data de Vencimento)

***

### O que é

Um QR Code dinâmico para **pagamentos com data de vencimento**, semelhante a um boleto.

Ele suporta:

* 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 associação
* Assinaturas ou cobranças recorrentes
* Faturas profissionais

### Características

* Contém informações completas de cobrança
* Permanece válido até a expiração
* A reconciliação é automatizada com base no ID da cobrança

## Pix Automático (Recorrente)

***

Usado para estabelecer **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 serviços públicos
* Serviços mensais

## Pix Saque

***

### O que é

Um QR Code que permite ao cliente **sacar dinheiro** em um estabelecimento comercial autorizado.

### Ideal para

* Lojas de varejo oferecendo conveniência similar a caixas eletrônicos
* Farmácias, supermercados ou lojas de conveniência

## Pix Troco

***

### O que é

Um QR Code usado quando o cliente paga **mais do que o valor da compra**, recebe o produto e obtém a diferença depositada como 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/dIivJl2jpQJ0JZcX/images/pt/d2/payment-qrcode-flow.svg?fit=max&auto=format&n=dIivJl2jpQJ0JZcX&q=85&s=e35fea3739ae1c139986f3e356a55469" alt="Fluxo de pagamento de um QR Code Pix, cobrindo os tipos de QR estático e dinâmico do escaneamento à liquidação" width="496" height="1210" data-path="images/pt/d2/payment-qrcode-flow.svg" />
</Frame>

## Fluxo completo do QR Code Pix

***

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

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

   Para QR Codes dinâmicos, o payload pode incluir valor predefinido, expiração e identificadores de reconciliação.

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

   O pagador escaneia o QR Code usando qualquer aplicativo bancário ou carteira habilitada para Pix e revisa os detalhes do pagamento antes de confirmar.

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

   Antes de enviar o pagamento, a instituição do pagador realiza validações obrigatórias, incluindo status da conta, saldo disponível, limites de transação e verificações internas de risco.

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

   Uma vez aprovada, a instrução de pagamento é encaminhada pelo SPI do BACEN para liquidação em tempo real.

   Se ambas as contas pertencem à mesma instituição, a transação pode ser liquidada internamente sem passar pelo SPI.

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

   A instituição recebedora credita os fundos na conta do beneficiário imediatamente após a liquidação, completando o pagamento.

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

   Notificações via webhook são emitidas para informar os backends do comerciante ou sistema sobre o resultado do pagamento, permitindo reconciliação automática, confirmação de pedido e atualizações contábeis.

# Casos de uso típicos

***

### Estático

* Uma padaria imprime um único QR Code para o balcão
* Uma barbearia compartilha seu QR Code pelo WhatsApp
* Um vendedor ambulante exibe um QR Code plastificado

### Dinâmico Imediato

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

### Dinâmico com Data de Vencimento

* Escolas gerando uma fatura mensal em QR Code
* Taxas de condomínio com regras de juros/desconto
* Freelancers emitindo faturas cobradas

### Saque / Troco

* Mercado oferece Pix Saque
* Cliente paga R$ 120 por uma compra de R$ 98 e recebe R\$ 22 de 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 obrigatória de CRC
* Estrutura de campos definida para cobranças dinâmicas
* Regras de expiração e cobrança para Cobrança (QR com data de vencimento)
* Limites de transação e janela noturna (quando aplicável)

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

  Esta página fornece uma visão prática de como o Pix funciona. Para detalhes técnicos, legais e regulatórios mais aprofundados — e para se manter atualizado com mudanças de regras, prazos e requisitos oficiais — sempre consulte a [documentação oficial](https://www.bcb.gov.br/estabilidadefinanceira/pix-normas) publicada pelo **Banco Central do Brasil (BACEN)**.

  Os materiais do BACEN são a fonte oficial para as regulamentações do Pix e contêm as especificações mais completas e atualizadas.
</Tip>
