Boleto híbrido é um boleto comum, com código de barras e linha digitável, que também traz um QR Code Pix. O cliente escolhe como pagar. Na AbacatePay, todo boleto já sai assim: pago pelo código de barras, custa R$ 2,50 e cai em D+3 úteis; pago pelo Pix, custa R$ 0,80 e cai na hora.
O que é boleto híbrido
É o boleto bancário de sempre — valor, vencimento, beneficiário e linha digitável — com um QR Code Pix impresso no mesmo documento. Uma cobrança só: o pagador usa o código de barras no banco ou o Pix no app.
Na AbacatePay isso já é o padrão. Emitir boleto (method: "BOLETO") devolve código de barras, linha digitável e o Pix daquela cobrança. Produto: gateway de boleto com Pix.
Boleto com Pix, Bolepix, Bolecode: é tudo a mesma coisa?
Sim, na prática. Bancos e gateways usam nomes comerciais diferentes (boleto com Pix, Bolepix, Bolecode, Bolix) para a mesma ideia: boleto + QR Code Pix no mesmo papel. O que importa é se o emissor oferece o QR — na AbacatePay, todo boleto sai com Pix.
Desde quando existe o boleto com QR Code Pix
A Resolução BCB nº 443, de 12 de dezembro de 2024 (acesso em 03/11/2026), em vigor desde 3 de fevereiro de 2025, disciplina o boleto e permitiu o pagamento por QR Code Pix no próprio boleto. O Banco Central permite, mas não obriga todo emissor a oferecer o QR. Por isso ainda existem boletos só com código de barras.
Como funciona o pagamento
O valor e o vencimento são os do boleto. O cliente escolhe o caminho no app do banco ou no caixa.
Pelo código de barras
O pagador digita a linha digitável, lê o código de barras ou paga no caixa. Depois da compensação bancária, o valor cai na sua conta AbacatePay em até D+3 dias úteis. A taxa é R$ 2,50 — só quando o boleto é pago. Gerar e deixar vencer não custa nada.
Pelo QR Code Pix
No app do banco, o cliente aponta a câmera para o QR (ou usa o Pix copia e cola que veio com a cobrança). O Pix roda 24 horas por dia, inclusive fim de semana. O saldo entra na hora e a taxa é a do Pix: R$ 0,80.
Boleto híbrido x boleto tradicional x Pix
| Forma de pagar | Horário | Quando cai (AbacatePay) | Taxa (AbacatePay) | Tem vencimento? | |
|---|---|---|---|---|---|
| Boleto híbrido | Código de barras ou QR Pix | Barras: horário do banco; Pix: 24/7 | Barras: D+3 úteis; Pix: na hora | Barras: R$ 2,50; Pix: R$ 0,80 | Sim |
| Boleto tradicional | Só código de barras / linha digitável | Horário do banco | Compensação em dias úteis | R$ 2,50 se for AbacatePay | Sim |
| Pix avulso | QR / copia e cola | 24/7 | Na hora | R$ 0,80 | Expira por tempo (expiresIn), não por data de fatura |
Se a dúvida é qual meio oferecer no dia a dia, o mapa comercial está em Pix ou boleto? O que oferecer.
Vantagens para quem cobra e para quem paga
- Cai na hora quando o cliente paga pelo Pix do boleto
- Paga em qualquer horário pelo QR — sem depender do expediente do banco
- Menos atraso por esquecimento de “só consigo pagar amanhã no caixa”
- Um documento só — sem emitir segunda cobrança só para oferecer Pix
Quem cobra cobre o público que ainda pede boleto e quem já vive no Pix. Quem paga escolhe o caminho mais fácil na hora.
O cliente pode pagar duas vezes?
O boleto híbrido é uma cobrança só. Quando o pagamento entra (pelo código de barras ou pelo Pix), o webhook transparent.completed avisa e você dá baixa no seu sistema. Não emita duas cobranças “uma de boleto e outra de Pix” para o mesmo valor — isso sim abre risco de pagamento duplicado.
Como confirmar e liberar o pedido: confirmar pagamento Pix automaticamente.
Como emitir boleto híbrido na AbacatePay
Valor mínimo: R$ 5,00. Exige nome e CPF/CNPJ do pagador. Vencimento padrão: 3 dias úteis; você pode escolher outra data, até 365 dias.
Sem código
Use o link de pagamento ou o checkout e escolha boleto. O Pix já vem na mesma cobrança.
Pela API
POST /v2/transparents/create com method: "BOLETO". O dueDate é opcional (YYYY-MM-DD). A resposta traz código de barras, linha digitável e o Pix do boleto.
{
"method": "BOLETO",
"data": {
"amount": 25000,
"customer": {
"name": "Mariana Costa",
"taxId": "987.654.321-00"
}
}
}Guias: API de boleto, API Pix e a documentação de boleto. Para QR Pix avulso: como gerar QR Code Pix via API.
Quanto custa
| Caminho do pagamento | Taxa | Quando cai |
|---|---|---|
| Código de barras | R$ 2,50 (só se pago) | até D+3 úteis |
| Pix do boleto | R$ 0,80 | na hora |
Simule no seu ticket: calculadora de taxas. Produto Pix: /pix.
E se o cliente atrasar?
Juros e multa são opcionais no boleto: você configura se quer aplicar depois do vencimento. Sem eles, a cobrança expira; com eles, o boleto pode continuar aberto para pagamento em atraso. Detalhes de produto em gateway de boleto. Para reduzir atraso com avisos e processo: régua de cobrança e como reduzir a inadimplência.
Perguntas frequentes
Boleto híbrido e boleto com Pix são a mesma coisa?
Sim. São nomes diferentes para o boleto que também traz QR Code Pix.
Se o cliente pagar pelo Pix, preciso dar baixa no boleto?
O pagamento é da mesma cobrança. Quando confirma, o webhook transparent.completed avisa — use esse evento para dar baixa no seu sistema.
A taxa muda se o cliente pagar pelo Pix?
Na AbacatePay, sim: R$ 0,80 se pagar pelo Pix do boleto; R$ 2,50 se pagar pelo código de barras.
Em quanto tempo o dinheiro do boleto híbrido cai?
Pelo Pix, na hora. Pelo código de barras, em até D+3 dias úteis depois da compensação.
Todo boleto tem QR Code Pix?
Não. O Banco Central permite, mas não obriga. Depende de quem emite. Na AbacatePay, todo boleto sai com Pix.
Como saber se um boleto com QR Code é verdadeiro?
Antes de confirmar no app, confira o beneficiário (nome e CNPJ). Desconfie de comprovante sem saldo na conta: comprovante Pix falso.
Preciso de CNPJ para emitir?
Sim. MEI serve: precisa de CNPJ? MEI também vale.
Fale com o time e emita seu primeiro boleto com Pix.
Leia também: régua de cobrança · como reduzir a inadimplência · Pix ou boleto?