Pix Cobrança: QR Code estático, dinâmico e fluxo de cobrança

Pix Cobrança é o conjunto de funcionalidades do Pix voltado à criação de cobranças com informações que ajudam o recebedor a identificar e acompanhar o pagamento. Dependendo do caso, a jornada pode usar QR Code estático, QR Code dinâmico ou Pix Copia e Cola.

Para empresas, a diferença mais importante não é apenas visual. Uma cobrança bem identificada facilita automação, conciliação e associação com pedido, fatura ou contrato.

QR Code estático e QR Code dinâmico

O QR Code estático pode ser reutilizado em cenários compatíveis e é adequado a fluxos mais simples. Já o QR Code dinâmico aponta para uma cobrança cujo conteúdo é obtido a partir de uma URL, permitindo que dados da cobrança sejam apresentados ao pagador de forma estruturada.

No padrão do Pix, o QR Code dinâmico contém uma localização que permite ao aplicativo do pagador recuperar o payload da cobrança. O manual do Banco Central deixa claro que, nesse modelo, as informações da cobrança vêm do payload obtido pela URL.

Pagamento imediato e cobrança com vencimento

A infraestrutura do Pix Cobrança contempla cobranças para pagamento imediato e cobranças com vencimento. A forma como essas modalidades são disponibilizadas depende da implementação e das regras vigentes do ecossistema Pix.

Como normas e manuais são atualizados, projetos em produção devem consultar sempre a documentação vigente do Banco Central em vez de congelar regras regulatórias no código.

O que acontece em um QR Code dinâmico

1. a empresa cria ou disponibiliza uma cobrança;
2. a aplicação apresenta QR Code ou Pix Copia e Cola;
3. o pagador lê o código no aplicativo da instituição;
4. o aplicativo identifica a localização da cobrança;
5. os dados estruturados são recuperados;
6. o pagador confere as informações;
7. o pagamento é iniciado;
8. a operação recebe a atualização e concilia a cobrança.

O fluxo oficial possui mais etapas entre participantes do Pix, mas essa visão é suficiente para entender a integração do lado da empresa.

Por que usar uma cobrança identificada

Se uma empresa recebe dezenas ou milhares de pagamentos, o desafio não é apenas receber dinheiro. É saber quem pagou o quê.

Uma cobrança bem modelada permite associar o pagamento a:

• pedido;
• fatura;
• assinatura;
• cliente;
• unidade de negócio;
• participante de um marketplace.

Isso reduz dependência de conferência manual e melhora a conciliação de pagamentos.

O papel do txid

O ecossistema Pix utiliza identificadores de transação para ajudar a relacionar cobranças e pagamentos. A forma de preenchimento e uso deve seguir o manual e a API adotada pelo participante que oferece a integração.

Em vez de inventar um padrão interno incompatível, a empresa deve guardar o identificador de seu pedido e também os identificadores externos retornados pela integração.

Pix Copia e Cola

O Pix Copia e Cola representa os dados necessários para iniciar a jornada sem exigir leitura da câmera. Para o usuário, é uma alternativa prática quando o pagamento acontece no mesmo dispositivo em que o QR Code seria exibido.

Para a empresa, QR Code e Copia e Cola devem apontar para a mesma lógica de cobrança e conciliação, evitando criar estados separados para a mesma obrigação financeira.

Como integrar sem criar dependência de tela

Uma integração robusta trata a cobrança como entidade no backend. O front-end apenas apresenta a experiência.

1. o backend cria a cobrança e salva o ID interno;
2. guarda o ID externo retornado;
3. o front-end exibe QR Code ou código;
4. webhooks atualizam o estado;
5. uma rotina de reconciliação confere exceções;
6. o pedido é liberado de forma idempotente.

Para a parte técnica, veja API Pix: como integrar pagamentos e webhook de pagamento.

Cuidados de implementação

• não confiar apenas na tela do navegador para confirmar pagamento;
• guardar identificadores interno e externo;
• tratar eventos duplicados;
• validar valor e estado antes de liberar pedido;
• preparar expiração e nova tentativa de cobrança;
• manter logs técnicos sem expor dados sensíveis;
• acompanhar atualizações dos manuais do Pix.

Fontes oficiais

Consulte o Banco Central — Pix, o Manual de Padrões para Iniciação do Pix e os demais manuais vigentes do Regulamento do Pix.

Nota editorial: este conteúdo explica conceitos do ecossistema Pix. A disponibilidade de funcionalidades específicas na GetKryon deve ser confirmada na documentação comercial e técnica vigente da plataforma.

Resumo

Pix Cobrança organiza a experiência de cobrança para que o pagamento tenha contexto e possa ser conciliado. Em operação de escala, essa identificação é tão importante quanto o próprio QR Code.