Skip to main content

Boleto híbrido

O boleto híbrido (ou bolepix) traz, no mesmo documento, o código de barras do boleto e um QR Code Pix. O pagador escolhe como pagar. A configuração é feita por carteira, de dois jeitos:

Tipo de ConfiguraçãoComo funciona
Gerenciado pelo bancoServiço do próprio banco: o banco gera o boleto e o QR Code Pix juntos, a partir da carteira com o bolepix configurado. Precisa ser contratado no banco e exige que a carteira tenha uma conexão associada. Só fica disponível para bancos que oferecem o serviço.
Gerenciado pela KobanaA Kobana monta o boleto híbrido: para cada boleto, cria também um Pix numa conta Pix sua. Permite combinar carteira e conta Pix de bancos diferentes.

Onde fica no painel​

Na tela da carteira, Ações > Configurar Boleto Híbrido. Salve com Atualizar Carteira.

Configurar​

  1. Ative Habilitar.
  2. Leia a Nota sobre precificação e cobrança e marque Li e estou de acordo com as condições de precificação acima. Sem essa confirmação, o painel mostra "É necessário confirmar que está ciente das condições de precificação para habilitar o Boleto Híbrido.". A confirmação é pedida só quando o boleto híbrido é habilitado.
  3. Em Tipo de Configuração, escolha Gerenciado pelo banco ou Gerenciado pela Kobana.
  4. Preencha as opções do tipo escolhido (abaixo).

:::caution Precificação Conforme a nota exibida na tela, o boleto híbrido gerenciado pela Kobana é contabilizado como 2 unidades de recebimento no mês (1 boleto e 1 Pix). No gerenciado pelo banco, são 2 unidades nos bancos que exigem a criação de um Pix e 1 unidade nos demais. :::

Gerenciado pela Kobana​

CampoObrigatórioDescrição
Conta PixSimConta Pix em que os Pix dos boletos são criados. Ela precisa estar ativa. Se não houver nenhuma, use Cadastrar nova Conta Pix.
Selecione o tipo de registro para os Pix associados aos boletos—Imediato ou Cobrança.

Com Cobrança, escolha quais informações do boleto são replicadas no Pix:

OpçãoComportamento
JurosO Pix não aceita dias para juros: os juros são cobrados no Pix desde o primeiro dia de atraso, independentemente dos dias para juros do boleto.
MultaO Pix não aceita dias para multa: a multa é cobrada no Pix desde o primeiro dia de atraso.
DescontosReplica os descontos do boleto no Pix.
Dias para baixaLigado, o Pix segue os dias para baixa do boleto; sem dias definidos no boleto, vale o padrão do Banco Central para Pix cobrança, de 30 dias. Desligado, o Pix é baixado no fim do dia do vencimento do boleto.

Gerenciado pelo banco​

Quando a opção está desabilitada, o próprio rótulo explica o motivo: o banco não oferece o serviço, ou a carteira não tem uma conexão associada (veja Ativação por API). Conforme o banco, a tela pede também a conta Pix usada no QR Code.

info

Trocar de um tipo de configuração para o outro remove a configuração anterior.

Desabilitar​

Desative Habilitar e salve. Os novos boletos da carteira deixam de ter QR Code Pix.

Como fica o boleto​

  • Gerenciado pela Kobana: ao emitir o boleto, a Kobana cria o Pix na conta Pix escolhida. O boleto ganha a aba Pix, com o Pix ligado a ele. Se o Pix não pode ser criado (por exemplo, com o vencimento já passado), a conta recebe o alerta "Erro ao gerar o Pix para o boleto híbrido".
  • A aba Compartilhar do boleto passa a mostrar Acessar Boleto Híbrido e Acessar Boleto Pix. Veja Envio ao pagador.
  • No gerenciado pela Kobana, quando o boleto é pago ou cancelado, o Pix ligado a ele é cancelado.
  • No gerenciado pela Kobana, quando o pagador paga pelo QR Code, o boleto recebe um recebimento do tipo Pix e a Kobana pede ao banco a baixa do boleto. Veja Pagamentos recebidos.

Permissões​

Configurar o boleto híbrido exige a permissão Ações Básicas no módulo Carteiras de Cobrança.