Como funciona o pagamento via QR Code Pix no boleto

Visão geral

Este conteúdo detalha o funcionamento e o processo de visualização do pagamento via QR Code Pix embutido nos boletos híbridos da plataforma, focando em fornecer uma orientação clara e prática para a execução e acompanhamento dessa rotina no sistema.

Quando usar este artigo

Utilize este guia sempre que houver necessidade de orientar inquilinos (locatários) sobre como efetuar o pagamento do aluguel utilizando o QR Code Pix contido na fatura, ou quando encontrar dúvidas sobre as regras de negócio de conciliação automática desse formato de recebimento.

Sintoma ou cenário

O inquilino deseja pagar a cobrança mensal de aluguel e encargos com a agilidade do Pix, utilizando a câmera do smartphone ou o aplicativo bancário para escanear o código impresso no boleto, reduzindo o tempo de digitação de linhas digitáveis extensas.

Benefício para o usuário ou operação

Facilidade de leitura e pagamento imediato para o cliente final.
Alternativa instantânea de pagamento a qualquer hora, inclusive em finais de semana.
Centraliza a baixa automática no caixa da imobiliária sem quebrar o fluxo de conciliação.

Onde acessar / contexto de uso

Acesse o sistema com suas credenciais e navegue até a ficha financeira do contrato em Contratos > Contratos ou diretamente na tela de gerenciamento de faturas em Receitas > Receitas a Receber.

Pré-requisitos (Antes de começar)

Perfil Exato: Permissões de consulta e gerenciamento no módulo financeiro e de contratos.
Recursos Sistêmicos: Conta de arrecadação via PJBank ou convênio híbrido homologado com a função Pix ativa no plano da imobiliária.
Insumos e Dados Técnicos: Cobrança de aluguel gerada e em aberto para o contrato de locação correspondente.

Causas prováveis

Necessidade de modernização dos meios de pagamento da carteira de locações, otimização da régua de cobrança ou execução de rotina periódica da imobiliária.

Como fazer ou corrigir

O QR Code Pix disponível no boleto transforma o documento em híbrido — o inquilino pode escolher entre pagar pelo código de barras tradicional ou escanear o QR Code.

Acesse o menu Contratos > Contratos;
Localize a busca, abra o contrato do locatário desejado e desça a página até o final da seção;
No bloco Cobranças do contrato em..., identifique o boleto do mês de referência atual;
Clique sobre o ícone de Informações do boleto (representado pelo logo do PJBank ou detalhamento do título);
O sistema abrirá uma janela contendo os metadados da cobrança e renderizará o QR Code Pix na tela;
Caso o inquilino esteja com dificuldades de leitura no documento PDF impresso, o operador pode copiar o código "Pix Copia e Cola" dessa mesma tela de informações ou capturar um print do QR Code para enviar via WhatsApp de suporte.

Resultado esperado

O QR Code Pix e o código Copia e Cola serão exibidos na tela, prontos para envio ao locatário ou para conferência antes do pagamento.

Quando escalar

Caso as cobranças emitidas pelo PJBank não estejam gerando a estampa do QR Code Pix no histórico de informações, ou se o sistema apresentar mensagens de erro críticas de comunicação com a API de recebíveis ao tentar carregar o bloco visual da fatura.

Informações que devem ser reunidas antes do escalonamento

Print da tela de informações do boleto demonstrando a ausência ou falha do código.
ID do contrato de locação e código numérico da cobrança afetada.
Nome da forma de recebimento (carteira bancária) vinculada ao contrato.
Data e hora do ocorrido.

Regras importantes / Observações

O QR Code Pix é uma extensão digital do boleto tradicional. Quando o inquilino paga via Pix, o gateway processa o recebimento e comanda a baixa automática no sistema, alimentando a esteira normal de repasses do contrato.
O sistema bancário possui trava automática contra duplicidade: assim que o pagamento é feito por um dos dois métodos (código de barras ou Pix), o outro é invalidado instantaneamente, impedindo pagamento duplicado.

Problemas comuns e como resolver

Problema: O inquilino tenta escanear o QR Code Pix no aplicativo do banco dele e recebe a mensagem "QR Code inválido" ou "Título indisponível para pagamento".
Causa provável: O boleto acabou de ser gerado no sistema imobiliário e a string descritiva do Pix ainda está na fila de sincronização assíncrona da API junto ao Banco Central.
Ação recomendada: Oriente o inquilino a aguardar um intervalo de até 15 minutos para que o lote de registro de chaves seja indexado e estabilizado na rede interbancária, ou peça para ele utilizar a linha digitável temporariamente se necessitar de urgência.
Problema: Os boletos da imobiliária estão saindo impressos apenas com o código de barras, sem o desenho do QR Code Pix no layout do PDF.
Causa provável: A carteira bancária cadastrada no sistema está parametrizada em uma modalidade sem registro Pix ou o modelo de layout padrão de impressão escolhido está desatualizado.
Ação recomendada: Acesse o menu Empresa > Formas de recebimento, abra as configurações da conta de arrecadação ativa e ative a flag de emissão de boletos híbridos (Boleto + Pix). Em seguida, comande a reemissão do PDF do contrato para atualizar o layout visual.

Dúvidas relacionadas

P: O pagamento por QR Code Pix antecipa a liberação do dinheiro para o repasse do proprietário no mesmo dia? R: Não obrigatoriamente. Embora o Pix seja uma modalidade de transferência instantânea para o pagador, as regras de compensação e repasse de lotes das imobiliárias que utilizam intermediadores financeiros (gateways) processam a consolidação de saldos no prazo padrão de fechamento de lote (D+1 útil), garantindo que as regras de splits de taxas administrativas sejam aplicadas corretamente junto com o restante das baixas do dia.

P: Como automatizar o envio do link do boleto com o QR Code direto para o e-mail do cliente? R: Isso pode ser feito ativando e parametrizando as mensagens eletrônicas automáticas dentro da ferramenta de Régua de Cobrança no menu de receitas. O sistema encaminhará o PDF completo do boleto híbrido de forma programada para as caixas de entrada dos locatários.

Palavras-chave de busca

boleto híbrido, Pix PJBank, informações do boleto, QR Code inválido, cobranças do contrato, pagamento Pix boleto