QrRapido/Content/DevTutoriais/qr-code-pix-estatico.pt-BR.md

title	description	keywords	author	date	lastmod	image
QR Code Pix Estático: Como Funciona e Responsabilidades do Desenvolvedor	Entenda o que é o QR Code Pix estático, como ele é gerado pela API, suas limitações e por que a verificação do pagamento é responsabilidade da sua aplicação — não da QRRapido.	qr code pix, pix estatico, qr code pix api, integração pix qr code, pix sem bacen	QRRapido	2026-03-08	2026-03-08

QR Code Pix Estático: Como Funciona e Responsabilidades do Desenvolvedor

O que é um QR Code Pix Estático?

O Pix tem dois tipos de QR code: estático e dinâmico.

	Pix Estático	Pix Dinâmico
Valor	Variável (pagador decide)	Fixo (definido pelo recebedor)
Geração	Qualquer sistema	Intermediário PSP/BACEN
Registro no BACEN	Não	Sim
Notificação de pagamento	Não	Sim (webhook)
Uso típico	Doações, cobranças simples	E-commerce, cobrança com controle

A API QRRapido gera exclusivamente QR code Pix estático. Isso é deliberado e suficiente para a maioria dos casos de uso.

---

Como a API Gera o QR Code Pix

Ao enviar uma requisição com type: "pix", a API monta uma string no padrão EMV® QR Code (padrão internacional adotado pelo Banco Central do Brasil) e gera a imagem:

{
  "type": "pix",
  "content": "contato@suaempresa.com.br"
}

O campo content deve conter apenas a chave Pix do recebedor. A API cuida de montar o payload EMV corretamente.

Chaves aceitas:

• E-mail: contato@empresa.com.br
• CPF/CNPJ: apenas dígitos — 12345678901 ou 12345678000195
• Telefone: +5511999999999
• Chave aleatória (EVP): 123e4567-e89b-12d3-a456-426614174000

---

O que a API NÃO faz (e por quê isso importa)

A QRRapido não tem integração com o Banco Central, com nenhum banco ou PSP (Provedor de Serviço de Pagamento).

Isso significa:

1. A API não sabe se o pagamento foi realizado. Ela apenas gera a imagem do QR code. O que acontece depois — se o cliente escaneou, se o Pix foi enviado, se caiu na conta certa — está fora do escopo da API.

2. Não há webhook de confirmação de pagamento. A API não envia notificações quando um Pix é recebido.

3. O QR code não expira automaticamente. Um QR code Pix estático é válido indefinidamente (ou até a chave Pix ser removida pelo recebedor no banco).

4. Não há rastreabilidade de transação. Duas requisições com a mesma chave geram o mesmo QR code (com cache). Não é possível associar um escaneamento a uma transação específica via API.

---

Responsabilidade da Sua Aplicação

Se você usa a API para gerar QR codes Pix em um fluxo de pagamento, é responsabilidade da sua aplicação verificar o recebimento. As formas corretas de fazer isso são:

Opção 1 — API Pix do Banco do Recebedor

Conecte-se diretamente à API Pix do banco onde está registrada a chave. A maioria dos bancos oferece:

• Consulta de cobranças recebidas
• Webhook de notificação em tempo real (quando o banco suporta)

Opção 2 — PSP / Gateway de Pagamento

Use um intermediário como Mercado Pago, PagSeguro, Efí Bank, Asaas, etc. Eles oferecem Pix dinâmico com controle completo: valor fixo, expiração, webhooks e identificação única por cobrança.

Opção 3 — Conferência Manual

Para volumes baixos ou contextos informais (doações, vendas presenciais), o responsável pelo recebimento verifica o extrato bancário manualmente.

---

Fluxo Recomendado (com confirmação)

Sua App                    API QRRapido           Banco do Recebedor
    |                           |                        |
    |-- POST /generate (pix) -->|                        |
    |<-- qrCodeBase64 ----------|                        |
    |                           |                        |
    |-- Exibe QR para cliente   |                        |
    |                           |                        |
    |-- Consulta pagamento ------------------------------>|
    |<-- Status recebido ou não --------------------------|
    |                           |                        |
    |-- Libera produto/serviço  |                        |

---

Exemplo de Requisição Completa

curl -X POST https://qrrapido.site/api/v1/QRManager/generate \
  -H "X-API-Key: sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "contato@suaempresa.com.br",
    "type": "pix",
    "size": 400,
    "outputFormat": "webp"
  }'

---

Casos de Uso Adequados para Pix Estático via API

• QR code de doação em site institucional
• Cardápio digital com chave para pagamento presencial
• Geração de QR em lote para materiais impressos (flyers, cartões)
• Aplicativos onde o vendedor e comprador interagem pessoalmente e o vendedor confirma o recebimento no app do banco

Casos de Uso que Requerem Pix Dinâmico (não atendidos por esta API)

• E-commerce com confirmação automática do pedido
• Cobrança com valor fixo e expiração
• Emissão de nota fiscal vinculada ao pagamento
• Conciliação financeira automatizada

---

Resumo

O que a API faz	O que a API NÃO faz
Gera a imagem do QR code Pix	Verifica se o pagamento foi feito
Formata o payload EMV corretamente	Envia webhook de confirmação
Entrega PNG, WebP ou SVG	Se comunica com o BACEN ou bancos
Funciona com qualquer chave Pix válida	Garante que a chave pertence a quem diz pertencer

A geração correta do QR code é responsabilidade da API. A confirmação do pagamento é responsabilidade da sua aplicação.