QR Codes

Os QR Codes Pix dinâmicos da conta são criados fora do FINANCE — pela integração da conta ou pelo aplicativo QR Pago — e ficam disponíveis nesta área para consulta. Pelo FINANCE você não cria QR Code: você localiza o QR Code já existente, confere valor, vencimento, devedor e recebedor, copia o BrCode (o “copia e cola”, que é o que o cliente usa para pagar) e acompanha webhooks e devoluções.

Como consultar os QR Codes da conta

1. Abra a listagem de QR Codes

No menu lateral, clique em RECEBER → QR Codes → Listagem.

A tabela lista os QR Codes gerados pela conta no período selecionado — por
padrão, com o atalho Hoje selecionado no filtro de período. Em cada linha você encontra:

• TxId — o identificador da cobrança no Pix;
• Valor — o valor do QR Code;
• Status — a situação do QR Code;
• Tipo da Cobrança — a forma de cobrança (Vencimento ou Imediata);
• Devedor e Documento — quem deve pagar e o CPF/CNPJ;
• Criação — data e hora em que o QR Code foi criado;
• Ações — o ícone Detalhes (o olho), que abre o QR Code.

No rodapé ficam a quantidade de itens por página (25 · 50 · 100 · 500) e a navegação entre páginas.

2. Localize o QR Code que você quer consultar

Use o campo Buscar ou, para um filtro preciso, clique em Avançado e monte a condição: escolha o campo (TxId, Valor, Status, Tipo da Cobrança, Devedor, Documento ou Criação), o operador e o valor. O operador é oferecido pelos campos Valor (Maior, Menor e Igual), Devedor (Contém e Não contém) e Criação (Depois, Antes e Igual); nos demais campos o operador já vem fixo em Igual e desabilitado, e o único campo editável é o de valor — em Status e Tipo da Cobrança o valor é escolhido em lista (no exemplo observado, Status traz Ativa, Concluída, Removida p/ usuário recebedor e Removida p/ PSP, e Tipo da Cobrança traz Imediata e Vencimento) e, em Documento, o campo pede o CPF ou CNPJ. Com o painel Avançado aberto, o campo Buscar fica indisponível e volta a funcionar quando o painel é fechado.

Para limitar por data, use os atalhos Hoje, 7d e 30d ou o botão Selecionar período, que abre o intervalo personalizado — DE e ATÉ obrigatórios, os atalhos 15d e 1m habilitados (no ambiente medido, 3m, 6m e 1a aparecem desabilitados), o aviso de que o intervalo máximo é de 31 dias e os botões Cancelar e Aplicar. À direita ficam os ícones de atualizar a lista e de exibir/ocultar colunas — esse último abre Colunas, com Todas as colunas, a marcação de cada coluna da tabela e Salvar.

O campo Buscar localiza o texto informado em todos os QR Codes da conta, sem considerar o período selecionado: no ambiente observado, com o atalho 7d ativo, a busca por um TxId de 18/09/2026 apresentou o QR Code, ainda que a data esteja fora dos últimos sete dias.

Se a tabela ficar vazia com “Nenhum item encontrado” e “Nenhum resultado para a data selecionada.”, o filtro de período pode estar restringindo o resultado — nesse caso, amplie o período (ou use Selecionar período) e limpe a busca no botão Limpar. As mesmas mensagens aparecem quando a busca não localiza nenhum QR Code.

3. Abra o QR Code

Na linha do QR Code, clique no ícone Detalhes (o olho, na coluna Ações). Abre a tela Dados do QRCode, com as informações daquele QR Code:

• VALOR ORIGINAL — o valor do QR Code;

• STATUS — a situação do QR Code, que podem ser:
  Ativa: O QR Code está disponível para pagamento e ainda não foi pago nem removido.
  Concluída: O QR Code foi pago e a cobrança foi encerrada. Nesse estado, ele não aceita um novo pagamento.
  Removida p/ usuário recebedor: O QR Code foi removido por quem recebe a cobrança, antes do pagamento.
  Removida p/ PSP: O QR Code foi removido automaticamente, por exemplo quando o QR Code expira.

  Ativa é o único status que ainda permite pagamento. Os outros três são status finais: Concluída quando houve pagamento e Removida p/ usuário recebedor ou Removida p/ PSP quando o QR Code foi encerrado sem pagamento.

• TIPO DA COBRANÇA — Com Vencimento ou Imediata;

• DATA DE CRIAÇÃO — data, hora e milésimos;

• VENCIMENTO — a data de vencimento da cobrança; em QR Code do tipo Imediata, sai como —;

• PAGÁVEL ATÉ — até quando o QR Code aceita pagamento; a data varia conforme a cobrança (no exemplo observado, 21/10/2026 para um vencimento em 21/09/2026 — 30 dias depois — e, em outro QR Code, a mesma data do vencimento); em QR Code do tipo Imediata, o campo exibido no lugar é EXPIRAÇÃO, com data, hora e milésimos;

• CHAVE PIX — a chave que recebe o pagamento, com botão de copiar ao lado;

• TXID — o identificador da cobrança, também com botão de copiar;

• SOLICITAÇÃO DO PAGADOR — o texto que identifica a cobrança na solicitação do pagador: no exemplo, a descrição informada na cobrança; em cobrança parcelada, aparece a parcela (ex.: Parcela 2/2).

À direita fica a imagem do QR Code. Abaixo, a tela mostra quem paga e quem recebe — Devedor (Nome e Documento) e Recebedor (Nome e Documento). Quando a cobrança não tem devedor informado, o bloco Devedor exibe o aviso “Devedor não informado”. Em seguida vem o Detalhamento do valor, com VALOR ORIGINAL, VALOR ATUAL, DESCONTO, MULTA, JUROS e ABATIMENTO (calculados com base na data atual), seguido de Juros e Multa, com os percentuais de juros e multa da cobrança e os campos de desconto e abatimento. Em QR Code do tipo Imediata o bloco Detalhamento do valor não é exibido: a tela vai direto para Juros e Multa, com os campos preenchidos com —. Em QR Code já removido (Removida p/ usuário recebedor ou Removida p/ PSP) o bloco Detalhamento do valor também não é exibido e, no lugar da imagem do QR Code, a tela apresenta o aviso “Cobrança removida.”.

No topo direito do detalhe fica o ícone de atualizar.

4. Copie o BrCode para enviar ao cliente

No bloco do QR Code, o botão Copiar BrCode coloca o “copia e cola” na área de transferência — é esse texto que você envia para o cliente pagar (por WhatsApp, e-mail ou por onde preferir). A Chave Pix e o TXID também podem ser copiados, cada um pelo botão ao lado do seu campo. Em QR Code já removido o botão Copiar BrCode não é exibido: ficam disponíveis apenas as cópias da Chave Pix e do TXID.

5. Acompanhe os webhooks e as devoluções

No fim do detalhe ficam três seções, que abrem e fecham ao clique:

• Webhooks configurados — os webhooks cadastrados para aquela chave Pix, uma linha por webhook (Status · Chave · Url · Criação); sem webhook cadastrado para a chave, a seção mostra “Nenhum webhook configurado para a chave Pix.”;
• Devoluções — as devoluções registradas para o QR Code; sem devolução, a seção mostra “Nenhuma devolução encontrada”;
• Tarefas webhook — as tarefas de webhook geradas, com o aviso de que os dados de webhook são armazenados por até 15 dias; sem tarefa gerada, a seção mostra “Nenhuma tarefa gerada”.

6. Consulte o histórico de disparos de webhook

No topo da listagem, clique em Histórico de webhooks. A tela reúne os disparos feitos pela conta — por padrão, “Os disparos ficam retidos por até 15 dias.” —, com o aviso “Atenção: Os dados de webhook são armazenados por até 15 dias.”, o botão Reenviar webhooks e os controles de busca, filtro Avançado e período (Hoje / 7d / 30d ou Selecionar período). O filtro Avançado desta tela tem três campos — Status, Inicio e Fim —, e não os sete da listagem: em Status o operador vem fixo em Igual e o valor é escolhido em lista (Processando, Finalizado, Cancelado e Erro); em Inicio e Fim o operador oferece Depois, Antes, Igual e Entre, e o valor pede Selecionar data e hora. Com o painel aberto, o campo de busca fica indisponível. Sem disparo no período, a tabela mostra “Nenhum item encontrado” e “Nenhum resultado para a data selecionada.”

Quando há registro no período, a tabela apresenta o andamento do envio nas colunas Status · Inicio · Fim · Webhooks · Criação · Atualização · Ações — a faixa de horário do envio, as datas de criação e de atualização e a ação Detalhes na última coluna. O rodapé apresenta a quantidade de itens por página (25 · 50 · 100 · 500), a navegação entre páginas e o total de itens encontrados.

O botão Reenviar webhooks abre a janela Reenviar webhooks, com os campos DATA/HORA INICIAL e DATA/HORA FINAL — por padrão, o dia atual, das 00:00 às 23:59 — e os botões Cancelar e Reenviar. Ao clicar em Reenviar, o sistema apresenta a confirmação “Deseja reenviar webhooks?”, com Cancelar e Sim, reenviar.

Após a confirmação, a janela é fechada, a mensagem “Webhook na fila” é apresentada e o pedido passa a ocupar uma linha da tabela, com Status Processando e os horários informados em Inicio e Fim. O ícone Detalhes, na coluna Ações, abre a janela do pedido, com STATUS, WEBHOOKS, INICIO e FIM e o botão Fechar. Concluído o processamento, o Status da linha passa a Finalizado depois de atualizar a lista pelo ícone Atualizar.

O que a área de QR Codes não faz

• Não cria QR Code — a criação vem da integração da conta ou do aplicativo QR Pago;
• Não cancela, não exclui, não edita e não baixa o QR Code: as ações disponíveis são consultar os dados e copiar Chave Pix, TXID e BrCode (a cópia do BrCode existe apenas em QR Code Ativa);
• Para cancelar a cobrança por trás do QR Code, use o menu Cobranças (veja o Guia Menu Cobranças);
• A lista não tem ordenação por coluna.

Se algo não sair como esperado

• Tabela vazia com “Nenhum item encontrado” e “Nenhum resultado para a data selecionada.” — o período está restringindo a lista. Volte para Hoje / 7d / 30d, escolha outro intervalo em Selecionar período ou limpe a busca no botão Limpar.
• A busca por texto não encontrou o QR Code — use o filtro Avançado, procurando por TxId, Devedor, Documento ou pelo período.
• Para confirmar que o pagamento entrou — acompanhe os lançamentos no Extrato.