Boleto Híbrido com QR Code PIX

O boleto híbrido é um boleto bancário que também pode ser pago via QR Code PIX. O cliente pode escolher pagar pelo código de barras tradicional ou escanear o QR Code com o aplicativo do banco para pagar via PIX.

Bancos suportados

Como funciona

O QR Code PIX não é gerado pelo sistema diretamente. Ele é gerado pelo banco após o registro do boleto. Por isso, o fluxo do boleto híbrido exige uma etapa a mais em relação ao boleto comum:

Emissão do boleto no sistemaGeração e envio da remessa ao bancoBanco processa e gera o QR Code PIXProcessamento do retorno bancário(QR Code é vinculado ao boleto)Reimpressão do boleto(agora com QR Code)Cliente paga via código de barrasou via QR Code PIX

Boletos híbridos não devem ser impressos antes do processamento do retorno, pois o QR Code ainda não está disponível.

Configuração

Passo 1 — Configurar a conta financeira

  1. Acesse o cadastro da Conta Financeira utilizada para o boleto
  2. Ative o parâmetro Aceita PIX
  3. Informe a chave PIX da conta (pode ser CPF/CNPJ, e-mail, celular ou chave aleatória)

Passo 2 — Configurar o tipo de documento

  1. Acesse o cadastro do Tipo de Documento utilizado para emitir boletos
  2. Vá até a aba Boleto
  3. Ative a opção Boleto híbrido (com QR Code PIX)

Após essas duas configurações, todos os boletos emitidos com esse tipo de documento serão híbridos.

Fluxo de uso

  1. Emita o boleto normalmente pela tela de emissão — o boleto será gerado sem o QR Code por enquanto
  2. Gere a remessa bancária e envie ao banco — como gerar remessa
  3. Aguarde o banco processar o arquivo (normalmente no mesmo dia útil)
  4. Importe o arquivo de retorno bancário — como processar retorno
  5. O sistema vincula o QR Code ao boleto automaticamente durante o processamento do retorno
  6. Reimprima o boleto — agora ele exibirá o QR Code PIX

Perguntas frequentes

O QR Code não aparece no boleto impresso. O que fazer?
O QR Code só é gerado após o processamento do retorno bancário. Certifique-se de que a remessa foi enviada e o retorno foi importado antes de reimprimir.

O cliente pode pagar o boleto híbrido antes de aparecer o QR Code?
Sim, pelo código de barras tradicional. O QR Code é um recurso adicional — o boleto permanece válido para pagamento via código de barras independentemente.

O desconto por antecipação funciona no pagamento via PIX?
Sim, desde que o banco suporte essa funcionalidade no boleto híbrido. O desconto configurado no tipo de documento é informado ao banco na remessa.

Veja também