6 min de leitura

Gerador de QR Code PIX: Como Funciona e Como Integrar a uma Cobrança

Entenda como gerar QR Code PIX estático e dinâmico, integrar a um sistema de cobrança e automatizar conciliação em tempo real.

pixqr-codeboletofuncionalidade

O gerador de QR Code PIX virou peça-chave de qualquer cobrança digital no Brasil. PIX é instantâneo, sem taxa para pessoa física e funciona 24/7. Mas usar QR como ferramenta de cobrança em escala exige entender quatro conceitos: estático versus dinâmico, EMV, TXID e conciliação via webhook.

Neste artigo, explicamos como cada um funciona e como o Chrema integra QR Code PIX à régua de cobrança sem trabalho operacional.

Como funciona um gerador de QR Code PIX

Antes de discutir cobrança, vale entender os fundamentos do QR Code PIX.

O que é o EMV (código copia-e-cola)

O EMV é o código de texto que codifica a cobrança PIX em formato padrão. Começa com 00020126 e contém chave PIX, valor (opcional), nome do recebedor, cidade e — para QR dinâmico — TXID. O cliente pode escanear o QR ou copiar e colar o EMV no app do banco. Ambos resultam na mesma cobrança.

Estático versus dinâmico

QR estático tem dados fixos: chave PIX, opcionalmente valor sugerido, e descrição curta. Serve para receber qualquer pagamento naquela chave — adesivo de loja, link em rede social, recebedor pessoal. Não tem TXID, então conciliar pagamentos exige cruzar valor e nome do pagador manualmente.

QR dinâmico é único por cobrança: chama o PSP (Provider de Serviço de Pagamento), que registra a cobrança no DICT do Banco Central com um TXID único. Quando o cliente paga, o PSP avisa via webhook informando o TXID, e o sistema concilia automaticamente. Para qualquer sistema de cobrança sério, sempre use QR dinâmico.

Geração via PSP

O Chrema gera o QR dinâmico chamando o PSP integrado (Asaas, StarkBank, Cora). Você passa dados da cobrança (valor, vencimento, identificador interno), o PSP registra no DICT e devolve EMV + TXID + URL da imagem PNG do QR. Tudo em segundos.

TXID e conciliação

O TXID é o identificador único da cobrança no DICT. Quando o pagamento é liquidado, o PSP envia webhook com o TXID, e o Chrema usa esse identificador para baixar a parcela correta — sem confusão mesmo se dois clientes pagaram o mesmo valor no mesmo segundo.

Expiração do QR

Por padrão, QR dinâmico expira em 1 hora após criação no DICT. Você pode estender a data de expiração até o vencimento da cobrança (configurando o campo expiracao na chamada ao PSP). Após expirar, o cliente precisa gerar QR novo — o que a régua de cobrança automatizada faz sozinha.

Por que gerar QR Code PIX direto no sistema de cobrança

Sem sistema dedicado, gerar QR para muitos clientes vira fonte de problema.

A primeira dor é a geração manual no app do banco. Cada cobrança exige operador abrir o app, gerar QR, copiar EMV, montar mensagem, enviar. Para 50 cobranças no dia, três horas perdidas. Para 500, impossível.

A segunda é a conciliação sem TXID. Sem TXID, sua planilha precisa cruzar nome do pagador (que muitas vezes não bate com o cliente cadastrado), valor e data — gerando erros. Pagamentos idênticos ficam ambíguos.

A terceira é a comunicação sem instruções claras. Cliente recebe QR mas não sabe que app abrir, onde colar, se PIX é a opção certa. Conversão cai porque a mensagem não guia o cliente.

Como o Chrema integra QR Code PIX à régua de cobrança

O Chrema trata QR Code PIX como saída nativa da régua, não como artefato adicional.

Geração automática ao criar parcela

Quando você cria dívida ou parcela recorrente, o Chrema gera o QR dinâmico já no momento — chamando o PSP integrado, salvando EMV, TXID e URL do PNG. A parcela já nasce com PIX pronto.

Inserção do QR e EMV nos templates

Templates de WhatsApp e e-mail do Chrema têm variáveis para pix_code (EMV) e link para a imagem do QR. Cada mensagem disparada pela régua inclui o código atualizado — cliente recebe instrução clara, copia-e-cola ou escaneia.

Webhook do PSP para baixa automática

Assim que o PIX é liquidado, o PSP envia webhook ao Chrema com o TXID. O sistema localiza a parcela, baixa o pagamento, dispara mensagem de confirmação via canal preferido, pausa a régua e atualiza o painel financeiro. Tudo em segundos.

Reenvio de QR atualizado se cliente não pagou

Se o cliente não pagou em N dias e o QR expirou, a régua dispara reenvio com QR novo. Cliente não perde tempo tentando pagar código expirado.

PIX em paralelo com boleto

Para clientes que preferem boleto (público mais velho, PJ tradicional), o Chrema envia ambos na mesma mensagem: código de barras, linha digitável, EMV PIX e QR. Cliente escolhe o canal de pagamento. Veja como gerenciar essa dualidade em sistema de cobrança com boleto e PIX.

Benefícios

Para qualquer operação que cobra digitalmente no Brasil, gerar QR Code PIX dentro do sistema de cobrança economiza três recursos: tempo operacional (geração em segundos sem operador), erros de conciliação (TXID elimina ambiguidade) e conversão (instruções claras no template). Para volume alto, o ganho vira diferença real no fluxo de caixa.

Veja preço e planos do Chrema para entender o custo de cobrança por PIX e boleto em cada faixa.

Perguntas frequentes

Qual a diferença entre QR Code PIX estático e dinâmico?

QR Code PIX estático contém dados fixos (chave PIX e opcionalmente valor) e funciona para receber qualquer pagamento naquela chave. QR Code PIX dinâmico é único por cobrança, com identificador (TXID) que permite conciliação automática. Para sistema de cobrança, sempre use dinâmico.

O gerador de QR Code PIX precisa de integração com banco?

Sim para QR dinâmico. O gerador chama o gateway ou PSP (Asaas, StarkBank, Cora, etc.) que registra a cobrança no DICT e devolve o EMV e o TXID. Para QR estático simples, basta a chave PIX e gerar local.

Como o cliente paga um QR Code PIX?

Abrindo o app do banco, opção PIX e Ler QR Code, apontando a câmera. Também pode copiar o código EMV (copia-e-cola) e colar no app. Pagamento instantâneo, 24/7, sem taxa para pessoa física.

O QR Code PIX expira?

Sim, se configurado. Por padrão, QR dinâmico expira em 1 hora após a geração no DICT. Você pode estender até o vencimento da cobrança. Após expirar, o cliente precisa gerar novo QR.

Como o sistema sabe que o cliente pagou via QR Code PIX?

Via webhook do PSP. Assim que o PIX é liquidado, o PSP envia notificação ao Chrema com o TXID da cobrança, que então baixa a parcela automaticamente, dispara confirmação ao cliente e pausa a régua de cobrança.

Pronto para automatizar sua cobranca?

Teste o Chrema gratis por 14 dias e veja a diferenca na sua operacao.

Testar 14 dias gratis
Voltar para o blog