6 min de leitura

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

Entenda como gerar QR Code PIX estatico e dinamico, integrar a um sistema de cobranca e automatizar conciliacao em tempo real.

pixqr-codeboletofuncionalidade

O gerador de QR Code PIX virou peca-chave de qualquer cobranca digital no Brasil. PIX e instantaneo, sem taxa para pessoa fisica e funciona 24/7. Mas usar QR como ferramenta de cobranca em escala exige entender quatro conceitos: estatico versus dinamico, EMV, TXID e conciliacao via webhook.

Neste artigo, explicamos como cada um funciona e como o Chrema integra QR Code PIX a regua de cobranca sem trabalho operacional.

Como funciona um gerador de QR Code PIX

Antes de discutir cobranca, vale entender os fundamentos do QR Code PIX.

O que e o EMV (codigo copia-e-cola)

O EMV e o codigo de texto que codifica a cobranca PIX em formato padrao. Comeca com 00020126 e contem chave PIX, valor (opcional), nome do recebedor, cidade e — para QR dinamico — TXID. O cliente pode escanear o QR ou copiar e colar o EMV no app do banco. Ambos resultam na mesma cobranca.

Estatico versus dinamico

QR estatico tem dados fixos: chave PIX, opcionalmente valor sugerido, e descricao curta. Serve para receber qualquer pagamento naquela chave — adesivo de loja, link em rede social, recebedor pessoal. Nao tem TXID, entao conciliar pagamentos exige cruzar valor e nome do pagador manualmente.

QR dinamico e unico por cobranca: chama o PSP (Provider de Servico de Pagamento), que registra a cobranca no DICT do Banco Central com um TXID unico. Quando o cliente paga, o PSP avisa via webhook informando o TXID, e o sistema concilia automaticamente. Para qualquer sistema de cobranca serio, sempre use QR dinamico.

Geracao via PSP

O Chrema gera o QR dinamico chamando o PSP integrado (Asaas, StarkBank, Cora). Voce passa dados da cobranca (valor, vencimento, identificador interno), o PSP registra no DICT e devolve EMV + TXID + URL da imagem PNG do QR. Tudo em segundos.

TXID e conciliacao

O TXID e o identificador unico da cobranca no DICT. Quando o pagamento e liquidado, o PSP envia webhook com o TXID, e o Chrema usa esse identificador para baixar a parcela correta — sem confusao mesmo se dois clientes pagaram o mesmo valor no mesmo segundo.

Expiracao do QR

Por padrao, QR dinamico expira em 1 hora apos criacao no DICT. Voce pode estender a data de expiracao ate o vencimento da cobranca (configurando o campo expiracao na chamada ao PSP). Apos expirar, o cliente precisa gerar QR novo — o que a regua de cobranca automatizada faz sozinha.

Por que gerar QR Code PIX direto no sistema de cobranca

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

A primeira dor e a geracao manual no app do banco. Cada cobranca exige operador abrir o app, gerar QR, copiar EMV, montar mensagem, enviar. Para 50 cobrancas no dia, tres horas perdidas. Para 500, impossivel.

A segunda e a conciliacao sem TXID. Sem TXID, sua planilha precisa cruzar nome do pagador (que muitas vezes nao bate com o cliente cadastrado), valor e data — gerando erros. Pagamentos identicos ficam ambiguos.

A terceira e a comunicacao sem instrucoes claras. Cliente recebe QR mas nao sabe que app abrir, onde colar, se PIX e a opcao certa. Conversao cai porque a mensagem nao guia o cliente.

Como o Chrema integra QR Code PIX a regua de cobranca

O Chrema trata QR Code PIX como saida nativa da regua, nao como artefato adicional.

Geracao automatica ao criar parcela

Quando voce cria divida ou parcela recorrente, o Chrema gera o QR dinamico ja no momento — chamando o PSP integrado, salvando EMV, TXID e URL do PNG. A parcela ja nasce com PIX pronto.

Insercao do QR e EMV nos templates

Templates de WhatsApp e e-mail do Chrema tem variaveis para pix_code (EMV) e link para a imagem do QR. Cada mensagem disparada pela regua inclui o codigo atualizado — cliente recebe instrucao clara, copia-e-cola ou escaneia.

Webhook do PSP para baixa automatica

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

Reenvio de QR atualizado se cliente nao pagou

Se o cliente nao pagou em N dias e o QR expirou, a regua dispara reenvio com QR novo. Cliente nao perde tempo tentando pagar codigo expirado.

PIX em paralelo com boleto

Para clientes que preferem boleto (publico mais velho, PJ tradicional), o Chrema envia ambos na mesma mensagem: codigo de barras, linha digitavel, EMV PIX e QR. Cliente escolhe o canal de pagamento. Veja como gerenciar essa dualidade em sistema de cobranca com boleto e PIX.

Beneficios

Para qualquer operacao que cobra digitalmente no Brasil, gerar QR Code PIX dentro do sistema de cobranca economiza tres recursos: tempo operacional (geracao em segundos sem operador), erros de conciliacao (TXID elimina ambiguidade) e conversao (instrucoes claras no template). Para volume alto, o ganho vira diferenca real no fluxo de caixa.

Veja preco e planos do Chrema para entender o custo de cobranca por PIX e boleto em cada faixa.

Perguntas frequentes

Qual a diferenca entre QR Code PIX estatico e dinamico?

QR Code PIX estatico contem dados fixos (chave PIX e opcionalmente valor) e funciona para receber qualquer pagamento naquela chave. QR Code PIX dinamico e unico por cobranca, com identificador (TXID) que permite conciliacao automatica. Para sistema de cobranca, sempre use dinamico.

O gerador de QR Code PIX precisa de integracao com banco?

Sim para QR dinamico. O gerador chama o gateway ou PSP (Asaas, StarkBank, Cora, etc.) que registra a cobranca no DICT e devolve o EMV e o TXID. Para QR estatico simples, basta a chave PIX e gerar local.

Como o cliente paga um QR Code PIX?

Abrindo o app do banco, opcao PIX e Ler QR Code, apontando a camera. Tambem pode copiar o codigo EMV (copia-e-cola) e colar no app. Pagamento instantaneo, 24/7, sem taxa para pessoa fisica.

O QR Code PIX expira?

Sim, se configurado. Por padrao, QR dinamico expira em 1 hora apos a geracao no DICT. Voce pode estender ate o vencimento da cobranca. Apos 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 e liquidado, o PSP envia notificacao ao Chrema com o TXID da cobranca, que entao baixa a parcela automaticamente, dispara confirmacao ao cliente e pausa a regua de cobranca.

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